SimpleAgentPro (SAPro)/SimpleAgentEnterprise (SAEnt) Release Notes

SimpleSoft is pleased to announce the following new releases of its SimpleAgentPro product.

SimpleAgentPro/SimpleAgentEnterprise Ver 27.5 Release Notes December 20, 2023

SNMP:
Added support for using GetBulk during learning in the GUI to speed up the recording of variables supported by a real device by almost a factor of 10.  This capability was already present when using the command line utility: sapwalk2.

Telnet/SSH:
Added support for including contents of specified files in the telnet modeling file by using %sapinclude directive.  This allows for common command processing to be saved in one file and shared by many other device profiles without having to duplicate its content.

Added support for automatic handling of <cmd | inc abc> where only those lines in the output of the cmd containing “abc” are displayed.  If an explicit cmd_action is specified for it, then that is used.  If it is not there, and the automatic handling is enabled, then it is supported internally.

Added support for automatic handling of <cmd | count abc> where the number of lines in the output of the cmd containing “abc” are displayed.  If an explicit cmd_action is specified for it, then that is used.  If it is not there, and the automatic handling is enabled, then it is supported internally.

Added support for automatic handling of <cmd | section abc> where the number of lines in the output of the cmd containing related to the section “abc” are displayed.  If an explicit cmd_action is specified for it, then that is used.  If it is not there, and the automatic handling is enabled, then it is supported internally when the configuration state information is saved.

Added the device IP address to the unknown command log in the <mapname>.log file

Netconf:
Added support to close all client connections from a Tcl script at the device level (SA_closeallconn netconf).

Added support for a callback %after_login_action which is called after the client hello is received.  At this time the client IP address information is available.

Added support for SA_netconf_renamedebugfile to allow the debug file created when the session is first started to be renamed later on.

Added support to call SA_external_getvaluewithtag and SA_external_setvaluewithtag from within the Netconf interpretor to allow it to examine and change variable values used in other sesions like Telnet/SSH sessions.

Added the device IP address to the unknown command log in the <mapname>.log file

HTTP2:
Added support to close all client connections from a Tcl script at the device level (SA_closeallconn http2).

HTTP/HTTPs:
Added support to close all client connections from a Tcl script at the device level (SA_closeallconn http and SA_closeallconn https)..

License Server/Client:

Added support in the License Server GUI to reflect the change in the expiry date after adding a new license without requiring a restart.

Native/Web GUI:
Added support for getBulk check box in the case of SNMPv2c and SNMPv3 SNMP learning.

IoT folder is no longer created when a new workspace is created.

The GUI reconnects with the NameServer when a new workspace is loaded.

Exporting of LoRa folder works better.

WebGUI now works with both TomCat v.9 and v.10

Utilities/Updates:
ncdconv utility has been updated to better handle “uri” based namespace prefixes.

SimpleAgentPro/SimpleAgentEnterprise Ver 27.0 Release Notes June 29, 2023

Common Data Modeling:
Added support for a common data representation for some variables so that their value can be consistent when returned by the various network management protocols supported by the device.
A data file containing the list of common variables identified by a lable and valuetype can now be optionally associated with a device in the general properties of the the device.
These variables can then be referenced in data files used by SNMP and Netconf using a new valuetype “cmndata(label)”.
The variables can be referenced in modeling files used by Telnet/SSH, Netconf, HTTP, HTTP2, HTTPCL, and HTTP2CL by using new Tcl commands like SA_getcmndata and SA_setcmndata.

Telnet/SSH:
Added support for saving configuration state information during provisioning to get reflected in subsequent show command output.
Support has been added for SA_addcmngroup, SA_addcmnmember, SA_delcmngroup, SA_delcmnmember, SA_getcmngroupid, SA_getcmngroup, SA_getpartcmngroup, SA_checkcmngroup calls to save/remove config commands from a config containment tree.
Support has been also added for SA_telnet_filtercmdoutput, SA_telnet_getfiltercount, SA_telnet_getfilteroutput to support “inc” and “count” type arguments.
Added fix for timing issue to get next available port when starting many maps simultaneously.

Telemetry:
Support has been added to simplify the specification of the GPB packets by using SA_gpb_start, SA_gpb_addcontainer, SA_gpb_addelement, and SA_gpb_endcontainer instead of tcl lists.
Updated sah2dconv utility to optionally generate output in this new format.

Netconf:
Added support for SA_netconf_disable and SA_netconf_enable to allow Netconf to programmatically disabled/enabled as a result of Telnet/SSH cli commands.

HTTP:
Added better support for binary data in chunked encoding response generation.

License Server/Client:

Added support in the License Server GUI to edit the blocked list of IPs.
Added support to udpate the running count of clients in the License Server GUI.
Added support to reflect updated expiry date in About box without restart.

Native/Web GUI:
Added support for a Telnet Modeling file debugger in the GUI, that allows the sending of telnet commands to a running device and seeing the console and debug output to facilate making corrections to the modeling file.
Fixed issue with path corruption in Tcl modeling file field in General Tab.
Fixed issues with not being able to stop trap creation from MIB for very large MIBs.
Corrected reading of Interfaces in the Set Configuration dialog on Linux.
Updated default type to Modeling in the Record and Create XML simulation dialog.
Added support for Domain name mapping to IP in embedded MIB Browser and other utilities.

IOT Module:
Modbus: enhanced sstclval, ssstep, ssfixed to better support floating values.
Modbus: added support for ssflstep and ssflrandom to generate floating point numbers.
LoRa: fixed issue with cloning of OTAA devices.
Modbus: added support for SA_mbus_setbigendian and SA_mbus_getbigendian to configure a device to set multiple register value order.
Modbus: added support for SA_mbus_convulongtofloat and SA_mbus_convfloattoulong for arithmetic operations in sstclval.

Utilities/Updates:
Fixed response of allstats in sapcnsl to display statistics of running maps.

SimpleAgentPro/SimpleAgentEnterprise Ver 26.5 Release Notes December 20, 2022

Netconf:
Added support to accept Netconf requests on additional IPs added to the same device context using SA_addip_servers tcl command.
Added support to maintain performance statistics for amount of time taken to process incoming request when THRESH_RESPTIME is set in config.inp.         

SNMP:
Added support to stagger timer action invocation for different devices in the same map. The timer periodicity is maintained, but the starting time can be randomized for different devices.
sapwalk2 now includes support to print out priv key information before building request for debugging.

Telnet/SSH:
Added support for knowing the remote host and port information to facilitate filtering of connections if desired.
tellearn/sshlearn now support clearlineflag which controls if the utitily will send clear cmd (0x15) or not.
sapt2tel now adds logout handling support and disables enable processing if prompt already ends with #.
sapt2tel was fixed to not put command prompt setting multiple times if there are multiple sessions.
Added support to accept Telnet/SSH connections on additional IPs added for the same device context.

HTTP:
Updated sahdconv utility now includes header information in created modeling files.
Updated sahdconv utility to handle both “#” and “# ” and escape content type information if it included quotes.
License Server/Client:
Added support to use USERINFO field in config.inp if present, when making license requests to license server. License server can show this client identifying information when seeing who is using the licenses.

Native/Web GUI:
Fixed the handling of loading workspaces with incomplete map file contents.
Fixed issues with device cloning when number of devices to be cloned was less than the number to be optimized.
Fixed issues with Map Statistics for HTTP Clients.
Fixed issues with starting and stopping individual devices when using WebGUI.
Added support for Domain name mapping to IP in embedded MIB Browser and other utilities.

IOT Module:
Modbus: fixed issue with incorrect length processing for ReadHoldingRegister command
CoAP: Removed device level locking when running scripts to facilitate Modbus Proxy commands.
LoRa: Basic station support has been enhanced to include fts information. Also servername and hostname have been updated to use domain name instead of mapped IP address.
Modbus: fixed issue with incorrect response generation for WriteMultipleRegister command, and slave id list parsing.

Utilities/Updates:
Updated default server.pem and skey.pem in http directory. The certificates are now valid till May 2023.

SimpleAgentPro/SimpleAgentEnterprise Ver 26.0 Release Notes July 29, 2022

Netconf:
Added support for valuelist in data file valuetypes, to give back comma separated values.
Added support to return remote IP and port info with SA_netconf_getremotehost and SA_netconf_getremoteport tcl calls.
Added support for SA_netconf_sleep to use instead of SA_sleep so that only the current session gets stopped and not the entire device.
Fixed issue with partial forwarded packets when receiving alarms.
Added support for SA_netconf_appenddata -nols to remove leading blanks from given string to better process pretty-p type output.
Fixed issue with with prefix in filter name space comparison, and cleanup processing checking.
ncdconv maps special xml characters when processing input.
ncdconv adds default handlers for edit-config and save-config if those requests are not present in input.
ncdconv adds support for pretty-p type output in modeling file creation.

SNMP:
Added support for AES-192-C and AES-256-C to use with Cisco’s implementation of key initialization.
Flushed debug output after every request in debug files instead of at the end.
sapdrow utility was made similar to the GUI processing.
sapwalk2 outputs Auth and Priv key during debugging to facilitate key mismatch troubleshooting.

Telnet/SSH:
Cleaned up debug output to make it more readable.
Added support for SA_telnet_sleep to use instead of SA_sleep so that only the current session gets stopped and not the entire device.
Added support to get remote port info during SSH session.
sapt2tel was fixed to not put command prompt setting multiple times if there are multiple sessions.

HTTP2:
Added support to make content length optional (and disabled it by default) with SA_http2_contentlenflag <0/1>.
Added support to return remote IP and port info with SA_http2_getremotehost and SA_http2_getremoteport tcl calls.
Added support for SA_http2_convhex2str and SA_http2_convstr2hex to handle hex to string conversion.
sah2dconv adds support for using subscription id in making requests.
sah2dconv adds support to break up data frames into multiple sends instead of collating them to make one big data frame.

HTTP2 Client:
Added support to specify a separate tcl file when creating subscriptions which will be sourced and its proc called periodically.
Added support to delete subscriptions.
Added support to call SA_getvar/SA_gnextvar/SA_setvar/SA_setvaltype to access SNMP data from telemetry application.
Added support for SA_http2cl_convhex2str and SA_http2cl_convstr2hex to handle hex to string conversion.

Native/Web GUI:
Set default 80,443 port numbers for http/https port in Record and Create and Multiprotocol dialogs.
Fixed license key update dialog to allow full key to be entered without validating each character.
Added support for AES-192-C and AES-256-C privacy types.
During mulitprotocol learning, sapw2var will be called after sapp2var in case of rules file specification.

IOT Module:
Modbus: fixed issue with single register change to take value from numcount
MQTT: fixed issue with argument count check.
Added support for AES-192-C and AES-256-C privacy types.
LoRa: added support for init_valuetypes, encode/decode base64, convert hex2str and str2hex, and fixed payload length issue.

Utilities/Fixes:
sapcnsl stopall processing will continue to stop other maps even if one of the maps reports an error.
Uninstall fixed to only remove default files.
Fixed clear statistics function.
sapcnsl now supports clearing map from sapns map list if resent due to error.
Better handling of duplicate object descriptors in MIB browser.
sapcnsl usage message updated to indicate the stats returned snmp statistics.

SimpleAgentPro/SimpleAgentEnterprise Ver 25.5 Release Notes Decemeber 14, 2021

Netconf:
Request forwarding now allows for mapping real device IP to proxy IP in responses.
Data model processing now also checks for request namespace when comparing with device data.
Data model processing better supports addition of new objects along with name spaces.
Request modeling file creation now automatically includes debugputs after requestparam setting to see the request information in debug mode.
Fixed blocking mutex calls in modeling file request processing.
Added support for SA_getreqparam_withns to get back request parameters with name space information for handling requests with differing name spaces.
Added support for optionally including 9 extra blank characters at the beginning of response when working with older modified opensshd servers.
Removed locking check for SA_getmyip call for faster session startup when using modeling file.

HTTP/2:
Improved proxy mode packet processing by only reading first 9 bytes and processing one packet/frame and forwarding it to the other side before reading additional bytes.
Added support to just send the header frames without any data frames for responses.
Added support to check if connection still active prior to sending async data frames.
Added support in sah2dconv utility to process debug files to client modeling files for proxy learning.

SNMP:
Removed check for SNMP enablement in SA_setmtusize call so that it can be used in proxy mode.
The SA_asynctcpservopen tcl command now supports an optional extra argument to specify mtu size to learn from agents supporting large requests/responses.
Added context name and context Id in the debug ouput of SNMPv3 messages.

Telnet/SSH:
Added additional commands like SA_telnet_clearcurrentcfgcmdscore, SA_telnet_resetcurrentcfgcmdscore, SA_telnet_issetcurrentcfgcmdscore, SA_telnet_setcurrentcfgcmdscore, SA_telnet_writecurrentcfgcmdscoretofile, SA_telnet_readcurrentcfgcmdscorefromfile to programmatically give back different “show” command responses after “config” commands.
Added fixes for configscore processing and enhanced sapt2tel utility to skip first line in response if same as command.
Enhanced sapt2tel utility to ignore space in comparing invalid request responses.
Added support for SA_telnet_setsshlocalecho to set local echo for ssh only. The same telnet modeling file can be used for both telnet and ssh, and the local echo can be controled when in ssh mode onl by this command.
Set end-of-line character to \n when acting as an SSH client and as \r\n when acting as a Telnet client by default. This can be also controlled by the SA_telnet_seteolouttype command.

License Server:
Added support to make the inactivity timeout value from last sapns contact configurable, by specifying SAPNSCHECKIN= in sapserv.ini.
Changed the default inactivity timeout value to 300 seconds from 180 seconds before license server closes the connection with sapns.
Added instance count to license summary output.

Native/Web GUI:
Updated the display of SNMP version selected in the SNMP properties tab to make the version selection more clear in Native GUI.
Added support to better synchronize the limit of number of deviecs supported between Native and WebGui.
WebGui now checks to see if config.ini and scenarios_map.sce exists when starting. Also fixed the error in saving LASTDEVICE information in config.ini file
Added better error message display when users try to simulate mode devices than those allowed.
WebGui now sends a trap file instead of buffer when supporting “Generate Traps” functionality.
WebGui fixed the “Scenario” script processing by specifying the correct full path of the script file.
WebGui now shows the version of the war file in the AboutBox and tooltip on the SimpleAgentPro icon in the login page.

Utilities/Fixes:
ncdconv utility better handles conversion to modeling file when no mapping is done.
saylconv utility now prints out “list” label with yang information for parents of key nodes.
sapns now checks for bad file descriptors and removes them to prevent looping.
sapcnsl now supports clearing map from sapns map list if resent due to error.
sapcnsl now supports updating device count for subscription license with license server, without stopping simulation.
sapcnsl now displays number of retries when sapns is disconnected from license server.
sapntgen now supports calling fping in parallel.

SimpleAgentPro/SimpleAgentEnterprise Ver 25.0 Release Notes July 27, 2021

HTTP/2 Client:
Simulated devices can now support HTTP/2 client functionality and periodically send gRPC telemetry data to NMS to support dial-out capability.
The sah2dconv utility has been enhanced to parse JSON telemetry data output from colletor and make similar client requests in the xcf modeling file.
The HTTP/2 clients can support multiple subscriptions to the same server and periodically send telemetry data frames on new and existing streams.
The gRPC length-prefixed-messages can include performance statistics that keep updating using valuetypes like randomup, utilization, step etc.

Netconf:
ncdconv utility now supports option to map real device IP addresses to a variable in the created modeling file to facilitate cloning.
ncsend utility has been enhanced to check for connectivity.
Support has been ehanced for checking namespaces in both get and get-config filter processing.
Added cisco-nc-learn-cmds.txt file to the installation so that it can be used during learning to learn many of the common objects. This command file can be used if devices do not respond to get/get-config requests without filters.
Support has been added for tclval(script) valuetype in Netconf data file, to allow the value to be dynamically computed as the return value of the evaluation of a tcl script.

SNMP:
Smaller cmf files can now be used, allowing devices to start quickly even when using dynamic row templates. Existing var file with large associated cmf files can be converted using sapw2var with the OUTPUT_OID=YES option, and index information is added to the dynamic row templates to not require extracting index information at runtime.
Cmf file name is added to the header when creating variables from MIB.
The value of the variable is set to NULL, if an invalid valuetype is specified in the var file.

Telnet/SSH:
Added support for SA_telnet_setexactmatch command to tell the simulator to not do best match when processing incoming command.
Added support for SA_telnet_definecfgcmdscore and SA_telnet_getcurrentcfgcmdscore to check for config cmds and keep track of a cumulative score that indicates which config commands have been received so far. This score can then be used to determine which response to give for show commands.
Enhanced sapt2tel utility to auto map information from show version output and extract serial number, macaddress and hostname for better cloning support using ssh proxy debug files.
Added support for SA_telnet_setsshlocalecho to set local echo for ssh only. The same telnet modeling file can be used for both telnet and ssh, and the local echo can be controled when in ssh mode onl by this command.
Set end-of-line character to \n when acting as an SSH client and as \r\n when acting as a Telnet client by default. This can be also controlled by the SA_telnet_seteolouttype command.

Native GUI:
Added support for exporting and importing maps in the current workspace. All the related files in the map are put into the associated folders and a zipped tar file created. This zipped file can then be imported on another computer running SimpleAgentPro and the files are extracted in project folder under the work directory.
Added support for checking device connectivity by invoking protocol specific command line utilities to connect with the simulated device.
Added cloning support option to multi-protocol proxy learning screen.
Updated defaults for SNMP learning to v2c and specified default directory for SSH in device properties.
Retained start times for already started maps in the display.

Utilities/Fixes:
tellearn and sshlearn supports sleeping for specified number of seconds between sending commands to keep the session alive.
ncsend ignores -c cmdfile option if file does not exist.
sapwalk2, sshlearn, tellearn, ncsend, ipmilearn, sahrqgen, vmlearn, sredfishlrn, sbacnetlrn, smqttlrn, smbuslrn, scoaplrn utilities support -y option to check for connectivity.
r_lastset() valuetype now better supports empty values.
supktcnv utility better handles ipfix packet conversion with templates.
Changed permissions of created password files for better support with newer version of proftpd.
Added support to dynamically change xml modeling file using SA_reload_xmlmodfile Tcl command.
sapcnsl can now start maps in a specififed folder.

SimpleAgentPro/SimpleAgentEnterprise Ver 24.5 Release Notes December 17, 2020

HTTP/2:
Simulated devices can now support HTTP/2 server functionality and periodically send gRPC telemetry data to NMS.
A HTTP/2 based proxy can be created to communicate with a real HTTP/2 server to forward requests and receive responses that are stored in a debug file for further processing.
A sah2dconv utility is available to convert http/2 debug files to a http/2 modeling file that can be used to seed the simulation.
Support has been added for encoding/decoding length-prefix-messages used in gRPC.

Netconf:
Added support for combining get and get-config data sections in Netconf data file format to automatically reflect changes done by edit-config in both get and get-config data.
Support has been added to ncdconv utility to convert output of ncsend to a Netconf modeling file.
Support has been enhanced for edit-config operations when using netconf data files.
Added support for async sockets for Netconf proxy in the GUI.
Support has been added to link SNMP and Netconf data in netconf data file using snmplink(oid.instance) value type.

SNMP:
Added support for SA_getcurtimesecs, SA_getcurtimemilli, SA_getcurtimemicro, SA_getcurtimenano to get current time in various resolutions.
IPv4 based tokens in the var file are automatically mapped to the last 4 octets of IPv6 simulation device addresses when using IPv6 with existing var files.
Added support for sending SNMPv3 Decryption Error Report PDU in case of mismatched keys.
Comments can be skipped when converting old var file to a new var file using sapw2var by using %SKIP_COMMENTS YES in the rules file.

Telnet:
Added support for sending partial response using SA_telnet_outputpartialresp command.
Enhanced support for very long incoming commands.
Enhanced sapt2tel utility to better handle grouped commands instead of the expected command-response pairs.
Native GUI/WebGUI:
Added better support for folders in WebGUI.
Added support for deleting users using in WebGUI.
Added support for editing any files present in the user directory.
Optimized performance when cloning devices in folders.

License Server:
Connections to existing client are deleted when the client is added to the block request list.
License keys can be updated more easily for expired and non-expired licenses.

Docker:
Docker images are now available upon request for non-gui and web-gui SimpleAgentPro installations.

Utilities/Fixes:
ncsend supports sleeping for specified number of seconds between sending mcommands to keep the session alive.

SimpleAgentPro/SimpleAgentEnterprise Ver 24.0 Release Notes July 8, 2020

Telnet:
Simulation can now to be setup to save config commands to memory. Later on, the presense or absense of config commands can be checked to give different output for show commands. This faciliates state based output across sessions.
The newly added Tcl command SA_telnet_autoaddcfgcmds in the %init_action section enable this behavior and command checking is done by using SA_telnet_gotcfgcmd and SA_telnet_got_partialcfgcmd Tcl commands.
Support has also been added to automatically save all received commands to a command log file by using SA_telnet_autoaddcmdtocmdlog Tcl call. The cmdlog file needs to be open prior to this call.
Support has been added for SA_telnet_getsessiontype Tcl command to find out what type of session it is. Values returned are SSH, Telnet, TL1, TL1SSH.
The SA_telnet_runcmdtofile processing has been updated to remove prompts and \r from the RESP section generated.
Support has been added for aync processing during proxy forwarding allowing requests and responses to appear in any order.

Netconf:
Added support xpath processing in addition to subtree processing when using data files.
Support has been added for aync processing during proxy forwarding allowing requests and responses to appear in any order.
Added support for call home functionality in ncsend utility to facilitate learning.

SNMP:
Added support for SA_getsimstartsecs to return the number of seconds since 1970 at the time when the device was started. This can assist in computing running time.
Added support for a new sawtooth() valuetype to provide values that lineary increase, reset, and then start linearly increasing again.
Added support for optional divisor to the tooth() valuetype function to have it grow more slowly.
clone.rul better handles empty hex strings when mapping.

Native GUI/WebGUI:
Added support for converting walk files in various formats to var files to use in simulation. This provides a GUI frontend to the popular sapw2var utility.
Added support for viewing Netconf statistics.
Added more detail to the initial login dialog to display IP information in case virtualization is detected.

TL1:
Added support for TL1 proxy to facilitate learning. The tl1learn utility has also been enhanced to process proxy debug files.
Added support for TL1 over SSH on non standard ports.

HTTP Server/Client
Added support in HTTP client for reading values from a csv file in SA_httpcl_initvaluetypes.
Added fix for better connecting with IPv6 HTTP servers.
Added support in HTTP server for Tcl commands like SA_xml_cleardevstring/appenddevstring/getdevstring to allow the saving of server data across http sessions.

License Server:
Added parameters to the command line interface to add and remove addresses from the block request list.
Added option to add host to the block request list when deleting it from the currently connected host list in the status tab.
Added the running device count in the License server’s command line summary output.

Utilities/Fixes:
sapt2tel support an additional pdbg3 option to better process proxy debug files. It also can created config command count based output.
sapt2tel also supports creating config command count based output, as well request command count based output.
sapw2var better supports exfo walk file format.
sapw2var better handles mapping of noAuthNoPriv enums in NetSnmp mapped walk outputs.
sapntgen allows to configure max threads to be used to simultaneously talk with large number of telnet servers.
Device and MIB installations have been updated to better support 64bit environments.

SimpleAgentPro/SimpleAgentEnterprise Ver 23.5 Release Notes December 18, 2019

Redfish:
Simulation now supports Redfish as a separate protocol in the device properties instead of having to use the HTTP/Rest properties.
A new sredfishlrn utility is included that recursively sends HTTP GET requests to a real Redfish server, parses the responses to look for supported URIs, and records the responses for all the supported URIs.
A Redfish proxy learner is added to the GUI to learn requests and responses by forwarding received requests from NMS to a real Redfish server.
The modeling file supports GET, POST, PATCH, PUT, DELETE actions that allow you to send scripted responses.

Netconf:
Added support for values that are saved across sessions using SA_netconf_initvaltypes.
The ncdconv utility better handles empty values in data file format.
Added support for step value type in data file format.
Added support for SNMP style standard tokens in the data file format.
Added support for lock, commit, cancel commit, commit confirmed, validate when using data files.
Optional automatic mapping of get and get-config data is supported.

WebGUI:
Added support for specification of Redfish device properties.
Added support for Redfish learning using sredfishlrn utility.
Added support for Redfish record and create(proxy) modeling file creation.
Increased built-in timeout for response to 40 seconds.

SNMP:
Added support for SA_getreqmaxreps to get the value of max repetitions specified in GetBulk request PDU.
Added support to specify empty variable binding list in the SA_setrespvb Tcl command
Fixed issue with additional user check when setting SNMP v3 trap user.
Added support for additonal tokens like $$MYIPADDRHDF$$, $$MYIPADDRHCF$$ to provide access to parts of the device IP string in hex format with dash or colon separator(01-02-03-04 or 01:02:03:04).
clone.rul optional rules file includes scripts for mapping entPhysicalSerialNum.1, chassisId.0, ceAssetSerialNumber.1 and ctsDevice.0. The existing scripts are also enhanced to better handle hex and display strings and take into account original value length when mapping.
sapwalk2 added support to decode incorrect encoding of BITS if the agent wrongly uses ASN1 BIT STRING for encoding.

Telnet/SSH:
Added support for better logging of all commands received.
Added support for SA_telnet_runcmdsgetoutput to dynamically run commands specified in a command list file and save the output in the specified output file. The output file can then be used by simulated Cisco devices to do bulk data transfer.

HTTP Server/Client
Added support to allow sending partial chunks.
Added support for SA_xml_decodebase64/SA_xml_encodebase64.
Added support for SA_xml_encodegpb/SA_xml_decodegpb to allow generation of google protocol buffer encoded data strings that can be used in sending telemetry data.

Utilities/Fixes:
sahdconv utility looks for chunked flag in the header.
stpktcnv utility now supports Linux cooked format pcap files.
stpktcnv utility no longer changes chunked packets to collated content-len type packets.
sapt2tel now better supports embedded netconf commands within telnet session proxy debug files.
sapt2tel added another file type “pdbg2” for better proxy debug file handling.
ncsend better handles very long commands, and includes server IP in output for subsequent mapping.

Note: Netconf, Redfish, SSH, WebGui, HTTP(s) are only supported in the Linux verison.

SimpleAgentPro/SimpleAgentEnterprise Ver 23.0 Release Notes July 24, 2019

Netconf:
Simulation now supports data file based simulation in addition to existing modeling file based simulation. Precedence is given to the information in the modeling file and if no corresponding request handler is found, the data file is looked into.
A new ncsend utility is added that sends get/get-config requests to the real device to learn their data. The utility also supports sending user defined requests. The ncdconv utility has been enhanced to convert the data recorded by ncsend utility into a data file to be used by the simulation.
ncdconv utility has been enahnced to handle messageids that are uuids and not just numbers.
Netconf proxy mode learner can now better handle initial hello coming from either side.
Netconf modeling file includes support for SA_netconf_getreqbuf to return the actual buffer received.
Netconf modeling file includes support for SA_netconf_setxmlinfo to optionally clear/set initial xml string in response buffer.

WebGUI:
Added support to generate and send SNMP traps.
Added support for Netconf learning.
Added support to share files among users by uploading and downloading from shared directories.
Added support to record user login/logout activity in user log file.
Added fixes to recover from corrupted map/workspace files.

SNMP:
Added support for additonal tokens like $$MYIPLST3IPS$$, $$MYIPLST3HEX$$, $$MYIPLST2IPS$$, $$MYIPLST2HEX$$ to provide access to parts of the device IP string.
Corrected the calculation of Diffie-Hellman derived keys on 64-bit Linux platforms.
Changed all tcl error messages to be prefixed with “TclError:” for easier identification in log files.
Added support for sapw2var to convert Exfo walk output format.

Telnet/SSH:
Added support for reading large responses in proxy mode by increasing buffer size.
Corrected username/password setting in ssh proxy mode.
Added support to add received commands to command log file.
Changed default timeout to 5 seconds and added support to look for “Password:” in case of enable command when in proxy mode.
Added support for SA_gettrapmgrs in telnet interpeter.
Added optional support to disable enable password echo in ssh mode.
Added support for better detection of prompt change in sapt2tel utility.

HTTP Server/Client
Added support for handling HEAD and OPTIONS type requests.
Added better handling of requests with very large header sections.
Added better handling of large buffers in encode/decode base64 Tcl commands.
Corrected uri wildcard specification and processing allowing partial uri’s to be specified in modeling files.
Corrected SA_xml_getjsonsimpletagval parsing.
Enhanced sahdconv to handled chunked encoded responses in proxy mode.
Enhanced sahdconv to auto create tcl code to handle different POST messages with different body information.
Added example tcl code to create serial number and mac address type strings based on device IP.

License Server:
License list returned only includes non-expired licenses.
Allowed host list is now properly saved when using the -f option.
License server breaks connection and removes host if request is from blocked IP.
License server closes connection and removes socket if request was denied.
License server upon receiving request from a client IP closes connection to a previous instance if no communication has been received from it in the last 5 mins, and gives license to new requestor.

LoRa:
Added support for GWMP and LoRa PHY messages to test LoRa Network Server.
Includes support for OTAA and ABP type of activation for simulated LoRa devices.
LoRa devices can send messages to multiple simulated LoRa Gateways.

Utilities/Fixes:
sapcnsl now allows devices in a map to be started using startdev, even if the map has not previously been started.
MIB Browser corrected calculation of Diffie-Hellman derived keys in 64-bit Linux platforms.
sapns reuses connection when retrying to connect to license server if license server had originally denied request.
saptgen added support for -x1 to give per command information.
Detailed steps to create Docker images for SimpleAgentPro and for running SimpleAgentPro in AWS VPC environment are available.

SimpleAgentPro/SimpleAgentEnterprise Ver 22.5 Release Notes December 14, 2018

Web GUI:
A web based GUI (beta version) included in the Linux version has been optimized for better performance and enhanced to support additional configuration options. It works in conjunction with Apache Tomcat to provide an http interface on port 8080.
Web GUI now allows the admin user to create new application users.
Scenario paramater support has been enhanced.
Users can add license key to config.inp when starting.
Users can create a workspace/project using WebGui like they can using Native Gui.

Licensing and License Server:
Added support for Elastic/External IP based keys for cloud based deployment on AWS/Azure.
Number of running devices in SimpleAgentPro/Enterprise is now shown in the License Status tab of the License Manager GUI provided SAPro version is 22.5.
Failed login attempts with invalid username and password are now recorded in transaction log.
Expired licenses are removed from the currently managed list of licenses.
Subnet mask of 255.255.255.0 is assumed instead of exiting when determination of actual subnet mask fails.

SNMP:
Added support for randomstr(formatstr, min, max divisor) valuetype to allow variable string based values to be returned.
Fixed issue related to dropping initial packets when device is disabled and then again enabled.
Disable ping Tcl command will now close all Telnet client connections.
Added support to save timestamp when the device processes a request.
The sapcnsl utility has been enhanced to show Idle/Busy device state in the “devinfolist” command depending on the device being talked with in the last 24 hours.
SimpleAgentEnterprise can now request less than 10 devices from the license server.
The trap generator utility “strapgen” has been enhanced to support “SA_getsyslogtstamp” and “SA_getutcsyslogtstamp” to dynamically generate timestamps in syslog messages.
The IPAddressTable line has been commented out in the clone.rul file to prevent IP addresses in the ipAddr table from being automatically mapped to user defined tokens.

Telnet/SSH:
Added support to log unknown commands if SA_telnet_logunknowncmds is called in init_action.
Added support to set command specific delays by calling SA_telnet_setreqdelay in the command action for that particular command. The delay is automatically reset after the response is sent out.
Added support to log message when max sessions are exceeded.
Added support to call SA_resetdevclock from within Telnet Tcl interpreter.
Removed clearing of telnetMemory in the case of device restart.
SA_setmaxallowedconn will be set to default when value specified is smaller than before.
Added support for SA_closeallconn to close all client connections.

TL1:
Added support to use 4 digit year string when SA_TL1_setyearformatflag is set to 1 in init_action section.
Added support to set command specific delays by calling SA_telnet_setreqdelay in the command action for that particular command. The delay is automatically reset after the response is sent out.

HTTP:
Added support for SA_xml_convhex2str in server Tcl interpretor.
Clients will use TLS1.2 when available to setup https connections.

Netconf:
Added support for optional buffer_flag to SA_netconf_requestforwarder to give back responses in the case of chunked encoding and not wait to get the whole response.
Added support for SA_netconf_sendintialreplychunk and SA_netconf_sendfinalreplychunk to use for sending very responses using chunking instead of using just one SA_netconf_sendreply call at the end of building the buffer.
Added support for SA_xml_encodebase64 and SA_xml_decodebase64 to Netconf Tcl interpreter.
Added support for SA_netconf_logunknowncmds and SA_netconf_setreqdelay to set request specific delays that get cleared upon request being processed.

Utilities:
Sapwalk2 has support for an extra argument (-w) to specify end of walk criteria.
Saptlog will use raw values for TimeTicks instead of the display string.
Tellearn supports -j option (just response) to save responses without converting to modeling file format.
New utility “ssclicfg” is being provided to parse tellearn output using -j option.
Sapw2var supports -i option to explicitly specify teacher IP for subsequent mapping.

BACNet:
Enhanced simulator to support Segmentation and unknown types.
Added support for valuelist() and timelist() value types.
Added support for SA_asyncudpbcastopen/close to allow broadcasts to be forwarded.

SimpleAgentPro/SimpleAgentEnterprise Ver 22.0 Release Notes July 18, 2018

Web GUI:
A web based GUI (beta version) is included in the Linux version to allow the control of the simulator using a Chrome web browser. It works in conjunction with Apache Tomcat to provide an http interface on port 8080.
Web GUI supports the creation of multiple users that can each have their own simulation environment. The special user “ssoft” allows existing maps to be viewed.

SNMP:
A new utility called ssfp2var (similar to the existing sapp2var) converts SNMP traffic captured in pcap files to a variable file that can be used for simulation. The earlier version used to take a very long time to process large pcap files with lots of request/responses. This has been now vastly improved.
The sappoll utility can now output data in a csv file format. This file output can later be used for additional processing.
Experimental support is now available for spoofing MAC address in small number of simulated devices.
The trap generator utility “strapgen” has been enhanced to support “-x 1” to make it silent and not output any status messages.

Telnet:
The telnet learner can now be told not to save the specified username and password in the modeling file but use a default admin/abc strings instead.
The “teacher’s” IP address is now automatically mapped to the tcl variable “myIP” in the telnet modeling file.

SSH:
The Telnet learner GUI has been enhanced to also support SSH based learning when port 22 is specified. The learner GUI calls the existing sshlearn command line utility to do the learn.
The SSH statistics are now available via the sapcnsl command “sshstats”.

HTTP-Server:
Added support for processing HTTP Get requests with non-zero Content Length.
Corrected processing of extra bytes read during initial read belonging to other requests.
Support for HTTP (local) which depended on a local HTTP server like Apache to be running on the simulator computer has been removed, since an embedded HTTP server has been part of the simulator for a while and offers richer request processing capabilities.

HTTP-Client:
Added support to listen to a UDP port within the HTTP client thread to process Tcl commands within the http client context.
Added support to dynamically change timer action interval for HTTP client processing.

Netflow/IPFIX:
Added support to properly parse IPFIX packets in a given pcap file and generate IPFIX data files.
Added support to properly handle different Netflow packet types when parsing pcap files.

MQTT:
Added support to send Tcl commands to MQTT broker over UDP sockets.
Added support to set MQTT bridge broker pretopic and subtopic strings via Tcl commands.

CoAP-Client:
Added support for CoAP client simulation to allow for simulating devices that simply act as a CoAP client sending POST messages to a specified CoAP server to get data and sending Observe request to get control/actuation messages.
The existing CoAP server still includes the ability to act as a CoAP client in addition to acting as a CoAP server.

MODBUS:
Added support for Encapsulated Interface Transport(43) to support the reading of Device Identification.

SimpleAgentPro/SimpleAgentEnterprise Ver 21.5 Release Notes December 18, 2017

Device Specific Certificates:
The Device properties dialog has been enhanced to allow for the specification of device specific Public and Private PEM keys to use with SSL related protocols.

Rules file to assist with Cloning:
Sample rules file to enable easier cloning of learnt device variable files is now included as part of the installation..
Rules file has also been enhanced to add support for fixed(%x) to map octet strings with printable ascii to make them into explicit hex strings.
If strings have starting or ending characters as blanks, although they are printable, they are treated as hex strings to avoid the spaces from getting lost in the var file formatting.

SNMP:
Support has been added for two new tokens $$MYIPSUBNHCF$$ and $$MYIPSUBNHDF$$. If the device IP is 10.1.2.4 then $$MYIPSUBNHCF$$ will have a value of 0A:01:02 while $$MYIPSUBNHDF$$ will get a value of 0A-01-02. These tokens are not supported in the oid part of the variable name.
In the case of IPv6 devices, support has been added for $$MYIPV6ADRES$$ and $$MYIPV6SUBNT$$. If the device IP is fdd0::1:2:3:4, the value of $$MYIPV6ADRES$$ in the oid part will be 253.208.0.0.0.0.0.0.0.1.0.2.0.3.0.4, and its value if the token is in the value type will be fdd0::1:2:3:4. In case of $$MYIPV6SUBNT$$, if it is in the oid part, it will be substituted by 253.208.0.0.0.0.0.0.0.1.0.2.0.3, and if in the value part it will be substituted by fdd0::1:2.
Default SNMP engineid in the case of IPv4 is made of 12 bytes as per the spec.
The order of checking for SNMPv3 report pdu errors has been updated to first look at snmpengineid and username. Checking for username has also been updated to make complete string comparissons.
Disbaled checking for license server disconnects to allow more resilency.

Telnet:
Added support for SA_external_setvaluewithtag/getvaluewithtag Tcl commands to enable the setting of variables from outside of the Telnet interpretor.
Added support for SA_telnet_send_http_s_req to allow HTTP/s requests to be sent from within the Telnet intepretor using the telnet modeling file.
Client sockets are opened with LINGER option to handle “exit” processing where the server closes the connection to prevent sockets from hanging in the TIME_WAIT state.

HTTP-Server:
Simulator has been enhanced to include better handling of the case where no content length or chuncked encoding is specfied in the header options. The simulator will continue to read until it receives a connection close from the client.
Support has been added for SA_xml_encodebase64 and SA_xml_decodebase64 calls to allow options to be encoded and validated.

TFTP:
The TFTP port can now be specified in the start_tftp tcl command to allow TFTP servers from getting started on non-standard ports.

Netconf:
Learnt netconf files will now include a SA_netconf_closeconnection call in case of close_session to prevent connections from lingering.
Enhanced the modeling file parsing to handle very long lines.

Name Server:
Added checks to avoid same map from being allowed to start twice during the time interval when the map was started but had not registered with Sapns. Also added code to return an error instead of waiting when the map could not get started due to license count error.

License Server:
Updated keep-alive logic to periodically check for lost connections and improved logging.
Added ability to checkout licenses via command line for fixed duration usage.
Included sapcnsl in installation to allow for closing of name server on client side.

HTTPCL:
Added support for seqinc and utilfloat value types in SA_httpcl_initvaluetypes call to give back sequentially increasing numbers as well as floating point formatted numbers.

Netflow:
Added timestamping information in debug files for packets sent in the separately priced Flow module.

MQTT:
Added code to rotate debug files if needed in the separately priced IoT module.

Utilities:
A new utility called saptrapgen has been added to support SNMP trap generation from command line. Devices referenced in the data file have to be part of running maps.

SimpleAgentPro/SimpleAgentEnterprise Ver 21.0 Release Notes July 18, 2017

SNMP:
SNMPv3 simulated devices now support newer authentication protocols in addition to MD5 and SHA in the AES version. Support for SHA2 protocol with HMAC lengths of 128 (uses SHA-224), 192 (uses SHA-256), 256 (uses SHA-384), and 384 (uses SHA-512) has now been added.
Support for handling the specification of very long values has been added to valueinfile() value type.

TL1:
Added support to broadcast autonomous messages to all currently connected client sessions.

SSH:
Added support for remote execution of SSH commands within simulated device contexts without displaying banner and prompt.
Added support for optionally disabling the echo of enable passwords in SSH sesssion.

Telnet:
Added support for SA_external_setvaluewithtag/getvaluewithtag Tcl commands to enable the setting of variables from outside of the Telnet interpretor.
Added support for SA_telnet_send_http_s_req to allow HTTP/s requests to be sent from within the Telnet intepretor using the telnet modeling file.

TFTP:
Support for IPv6 has now been added to the satftpd daemon to allow IPv6 simulated devices to also support TFTP server functionality.

Netflow:
Corrected fixed length handling of In_bytes and In_pkts in version 9 to use lengths specified in templates.

Scenarios:
Map level scenarios can now be optionally associated with a specific map name. The scenario choices displayed for a running map will be limited to those that are specifically associated with it and those that are globally available.

Name Server:
Support for service and systemctl style daemons has been added in the installation scripts to support different flavors of Ubuntu.

License Server:
Support for service and systemctl style daemons has also been added in the installation scripts of license server to support different flavors of Ubuntu.

HTTPCL:
Added support for hostname mapping in the HTTP server IP specificatioHTTP server IP specification.
Added support for SA_eval_protocol_tclcmd/script to externally cause the evaluation of scripts in the HTTP clien Tcl interpretors.

MQTT:
Added support for hostname mapping in the MQTT broker IP specification, within the separately priced IoT module.
Added support for SA_eval_protocol_tclcmd/script to externally cause the evaluation of scripts in the MQTT client Tcl interpretors within the separately priced IoT module.

Utilities:
Added support for IPv6 pcap parsing in sapp2var and sapt2tel utilities.
Added support to decode SNMPv3 packets in sapp2var.
Added support to better handle UDP packet fragmentation in sapp2var.

Bug Fixes/Enhancements:
Statistics for HTTP Client and BACNet are now available for display.
Document Type Definition (DTD) for SimpleAgentPro map file format is now included in the doc/sapro directory.
Better handling of chunked encoding when sending binary data in simulated HTTP server.
Added support for wildcards in the uri matching for HTTP server modeling file.

SimpleAgentPro/SimpleAgentEnterprise Ver 20.5 Release Notes December 15, 2016

Telnet:
Support for Virtual Device Contexts has been added to Telnet modeling files by having a %context_cmd_action section to support devices like Cisco Nexus 7000 series that support switching to different contexts.
Valuetypes like random/utilization/valuelist are now also available to give back changing values in Telnet/SSH/TL1 responses.
Tcl command SA_telnet_gettimesincelastcmd is now available to facilitate closing of client connections due to inactivity.
Tcl command SA_telnet_getpeerinfo is now supported to get client IP and port information.

SNMP:
Gauge valuetype is now automatically mapped to “fixed()” valuetype instead of “random()” valuetype to remove confusion with changing values for MIB variables like ifSpeed.
Added auto checking of SNMPv3 contexts for “vlan-” in addition to “” in the case of community string indexing of bridge mib information supported by Cisco switches.
Added support for %before_devices_start and %after_device_stop to setup files to allow evaluation of scripts prior to map device startup and upon closure.
Added support for $$MYIPADDRHEX$$ default token that is based on the IP address of the simulated device. If the IP is 1.2.3.4, the value of this token will be 01020304.
Added support for SA_setnotifyuser to allow the specification of a different user profile in the generated SNMPv3 notifications.
Supports specification of 4K long values in valuelistinfile.

Multi Protocol Proxy:
Multiple protocols can be simultaneously proxied by forwarding incoming requests on multiple protocol specific ports to corresponding ports on a real device and capturing their returned responses. The captured request/response exchanges can then be converted to data/modeling files for subsequent use in simulation.
Protocols supported include SNMP, Telnet, SSH, Netconf, and HTTP/s.

Netconf:
Netconf proxy forwarding support has now been added to enable proxy based learning of responses.
Added Netconf “call home” proxy support to allow the simulated device’s server to initiate a Netconf connection with Manager acting as a client instead of waiting for the manager to connect to it.

Scenarios:
Project specific scenarios can be created and saved in projects folder to allow for better organization of scenarios on a per project basis.

IoT Module:
BACnet/IP server support is added within the separately priced IoT module. It includes a learner to record supported objects and their properties.
MQTT client within the separately priced IoT module now supports transmission of messages over WebSockets. Support has also been added for the ssgpslinear() valuetype.

Utilities:
A new sshlearn utility that acts as an ssh client and sends a list of commands specified in a file to a SSH server and records its responses to create a telnet/ssh modeling file is now available. It supports the same syntax as the tellearn utility.
A new sssproxyfwd utility is now available that acts as proxy forwarder listening on specified ports and forwarding received packets to a specified server and returning its responses. The request response packet exchange is recorded in a debug file for subsequent conversion into data/modeling files used for simulation.
sapw2var and sapt2tel also support parsing of Cisco Prime Network (cpn) persistency files to create snmp and telnet data and modeling files for simulation.
ncdconv utility can now be told to skip duplicate responses.
sapwalk2 now allows the specification of mtu size to allow learning of long values.
Bug Fixes/Enhancements:
Better detection of command prompt changes in tellearn and sapt2tel.
Fixed HTTPclient debug files getting overwritten by information from other sessions.

SimpleAgentPro/SimpleAgentEnterprise Ver 20.0 Release Notes June 15, 2016

HTTP-Client:
Simulated devices can now act as http clients to register themselves with a specified HTTP server. HTTP Get/Post requests can be sent out, and responses processed.
Tcl commands in an associated HTTP Client Modeling file determine the requests that are to be sent out either upon startup (%init_action) or periodically (%timer_action). Responses can be processed in the (recvresp_action) associated callback.
The HTTP client modeling file can be created by parsing debug files with the updated sahdconv utility.
Registration for plug and play type devices can be scripted using HTTP-Client functionality.

Telnet:
Telnet Tcl commands for global alias, and waiting for new line have been added to facilitate simpler command processing and abbreviated commands.
The telnet learner program (tellearn) has been enhanced to also support %addtoinit% and %addtofile% to allow easier creating of telnet modeling files from command scripts.
Tcl commands SA_telnet_setmaxallowedconn and SA_setmaxallowedconn, enable the control of the number of simultaneous connections accepted by the simulator to quickly create error scenaorios.

Run without GUI:
If the RUN_WITHOUT_GUI option is specified in the config.inp file, maps started by the sapro/saent GUI will continue to run, even if the GUI gets closed.
When the GUI is restarted, it can connect with already running maps and be able to get updated status for them as long as they are in the GUI’s workspace.
This is particularly useful when the terminal used to start the GUI is inadvertently closed or forced to be closed, causing all the simulations to stop.
Maps started externally by sapcnsl can be seen by the GUI when the “Update Running Maps” popup menu is chosen.

SNMP:
Support has been added for two additional tokens $$MYIPSUBNIDS$$ and $$MYIPSUBNHEX$$ that are based on the IP address of the simulated device. If the simulated device IP is 10.5.1.3, then the value of the first token will be 10.5.1 and the value of the second token will be 0x0a0501.
The rules file syntax used by sapw2var to convert walk files to var files has been enhanced to include special tokens like fixed($lc$) and fixed($fc$) inside the valuetype to take the last characters to the value of the variable retrieved in the walk or the first characters, instead of just fixed(%s) as was supported in the past.
The rules file syntax used by sapw2var to convert walk files to var files has also been enhanced to include %appendbefore, %appendafter and %tclscript to allow insertion of variables not present in the walk file, and manipulation of the value via script based logic.
When creating var files from pcap files, sapp2var has been enhanced to treat variable bindings inside SET requests as RW variables.
SAPro GUI now allows multiple trap managers to be specified in the trap generation dialog.

Utilities:
Sapt2tel has been enhanced to be more similar to tellearn in the output created.
tellearn has been enhanced to speed up the command learning by looking for prompts instead of waiting for timeout.
Sathrd/Tcl Commands:
SA_xml_proxyfwd_ipmap tcl command allows xml proxy based learning to map real server IP address to the proxy IP address in the response data.
SA_setoerflag tcl command allows devices to support OER encoding instead of the standard BER encoding for SNMP packets.
Bug Fixes/Enhancements:
Sathrd creates log directory if none exists.
Statistics given by sapcnsl have been expanded with additional data.
Some configuration settings can be changed without stopping sapns.
License Information is available via sapcnsl with the “showlicense” option.

SimpleAgentPro/SimpleAgentEnterprise Ver 19.5 Release Notes December 15, 2015

Telnet:
Telnet proxy based learning has been enhanced to support SSH. Now a SSH proxy can be used to learn telnet responses and create a telnet modeling file for simulation.
The telnet learner program has been enhanced to also support %TCMDRESP% to allow the telnet response to be saved in a tcl variable that can be parsed for determining additional commands to learn. Support has also been added for exact command checking.
The telnet modeling file format has been enhanced to include exact command matching as well as multiple command matching like “sh ver”,”show ver”,”show version” in one cmd_action.
The sapt2tel command line utility has been enhanced to processs multiple simultaneous tcp sessions in the the captured pcap file and better handle netconf responses.

SNMP:
The device properties now include an option to enable TCP in addition to UDP on the specified SNMP port. This enables the simulator to process SNMP requests over TCP without needing any additional Tcl commands to enable this.
The “Learn from Device” option also allows learning of SNMP data from real devices over TCP, and the embedded MIB Browser has also been enhanced to support TCP. sapwalk2 command line utility also supports doing SNMP walks over TCP.
Map User Data can be optionally prepended to the Device Topology Data field in case of common tokens that need to be shared by all devices in a map.
SNMP debug files can be rotated into a set of files so that they do not grow without any set limits. This behaviour is controlled by specifying debug file rotation size and count in the config.inp file.
The variable file format has been enhanced to support “%sapinclude” key word to allow inclusion of common variable data in multiple var files.

TL1 over SSH:
Support has now been added to allow TL1 to run over SSH in addition to Telnet. If SSH option is specified in the device properties, TL1 clients can connect with the simulator over SSH with the specified username and password. TL1 over SSH also uses the modified opensshd server like the SSH simulator.

Utilities:
Saptlog has been enhanced to handle IP fragmentation.
Sapvsort has been enhanced to optionally retain comments from the original file in the sorted output.
Sapwalk2 has been enhanced to do walks on a list of oids specified in a file.
TL1learn can auto cleanup partial lines in the TL1 response file.

Sathrd/Tcl Commands:
SA_tftpget and SA_tftpput can now be setup to output a character like “!” for every block it receives in the telnet session.
User defined counters can be setup via Tcl commands like SA_createuserstats and SA_incruserstats, and they can be made available via sapcnsl command line utility with the -c userstats option.

Modbus support:
The separately priced IoT module that works with SimpleAgentPro/Enterprise on Linux is now enhanced to include support for Modbus over TCP in addition to CoAP and MQTT. Modbus over TCP servers can be setup to support multiple Modbus slaves and respond to Modbus requests over TCP based on information in an associated data file.
As part of the IoT module, a Modbus learner that sends Modbus requests to a real Modbus over TCP server, and learns the address map and values for subsequent simulation, is included.

VMware vSphere API support:
Support has been added for %sapinclude to data file format. VMware vSphere API support is part of a separately priced Cloud module.

Netconf:
Support has been added for SA_netconf_sendnotification and SA_netconf_sendrawdata commands.

Bug Fixes/Enhancements:
Saptrlrn utility that learns snmp traps output has been fixed so that the file can be loaded in the GUI to send traps.
Supktcnv and Netflow module have been enhanced to handle Netflow version 9 correctly.
Default server.pem and skey.pem have been updated for SSH2.

SimpleAgentPro/SimpleAgentEnterprise Ver 19.0 Release Notes June 30, 2015

Telnet:
Telnet responses from a real device can now be learnt and converted to a telnet modelding file by simulating a proxy device that forwards application requests to a configured real device. It then returns the responses from the real device back to the application and creates a debug file that contains the requests and responses. This debug file can then be converted to a telnet modeling file. When the list of telnet commands sent by the application is not known before hand, the proxy can be used to do recording.
The telnet learner program has been enhanced to support command completion response based learning. Three additional keywords %CMDCOMP%, %RCMDCOMP% and %TCMDCOMP% allow the substitution of command completion response to facilitate learning. A recursive mode as well as tcl variable mode is supported.
The telnet simulator now includes built-in support for netconf queries to support “netconf echo” style IOS commands. A new %netconf_cmd_action keyword is added to the telnet modeling file and it allows the generation of netconf responses. The special netconf terminator of “]]>]]>” is used to demark the end of netconf queries.
The sapt2tel command line utility has been enhanced to also process netconf request and responses. It looks for the “netconf echo” style IOS command for special processing.

SNMP:
SA_snmptcpopen and SA_snmptcpclose tcl commands have been added to the device tcl interpretor to allow handling of SNMP requests over TCP in addition to the standard UDP port. The specified TCP port is opened and the simulator waits to receive connections on it and then processes SNMP requests over the connection.
Traps can also be sent on the tcp connection by specifying TCP as a special keyword in the trap manager list.

Cloud Wizard:
An option to create maps containing simulated hosts and VMs with their associated SNMP variable files is now provided when creating vCenters with hosts and VMs based on template learnt file.
The cloning utility vmndata has now been enhanced to delete non-template hosts and VMs from the new vCenter data file.

Sapcnsl:
Sapcnsl has been enhanced to support retrieval of the status of all maps within a workspace.
Sapcnsl can now also start all maps in a workspace to make the task of starting maps easier.
Sathrd/Tcl Commands:
Tcl Command to enable wildcard pattern matching in XML based request/response files now supports multiple wildcards.

MQTT support:
The separately priced IoT module that works with SimpleAgentPro/Enterprise on Linux is now enhanced to include support for MQTT in addition to CoAP. MQTT simulated sensors can be setup to periodically publish messages to a specified MQTT broker.
As part of the IoT module, a MQTT learner that subscribes to a specified broker and learns publish requests from real sensors for subsequent playback is included.

VMware vSphere API support:
Support has been added for additional VMware vSphere API calls like FetchDVPorts.
vmlearn utility is enhanced to learn few more responses.
vmsearch utility has been added to search for specified values in the data file.

Bug Fixes/Enhancements:
Tcl Debug files can be rotated when file size exceeds a specified max size.
Non conflicting handling of SSH and Netconf interfaces with sshd configuration files.

SimpleAgentPro/SimpleAgentEnterprise Ver 18.5 Release Notes December 16, 2014

Netconf:
Simulated devices can now also support Netconf over SSH within SAPro/SAEnt. It works in conjunction with the modified opensshd server configured to listen to Netconf port 830. This feature is currently available in the Linux version only. The Netconf simulator uses a telnet style modeling file approach for simulation.
A proxy based learning mode is supported where in requests from the management application come to the simulated device which simply forwards the request to a real Netconf server. The simulated device then sends the responses received from the real Netconf server back to the management application and creates debug files that record both request/responses.
A new ncdconv utility is also provided which converts the debug files created in the proxy mode into a netconf modeling file that can later be used for simulation without the need to have a connection to a real Netconf server.

Flag Action support for coordinated execution:
%flag_action section is now added to the modeling file syntax to allow for evaluation of tcl scripts in device context upon receiving a TCP message. The SAPro/SAEnt GUI, the sapcnsl command line utility as well as Tcl commands like SA_setflagactionid can be used to trigger this action.
This section is useful in triggering script execution in a specific device, in all devices in a specific map, and in all devices in all running maps.

Topology Editor:
An option to load the generated map into the current workspace in SAPro/SAEnt is now provided.
A command line flag is now added to disable the redundant link limit checks.
Users can now specify the base directory for the generated project. The default directory of “../projects” is not changed.
Generated maps are now automaticaly optimized and broken up into multiple maps.

Sapcnsl:
Sapcnsl has been enhanced to support retrieval of cable performance statistics using the cablestats command.
Sapcnsl also supports SNMP performance statistics retrieval if the THRESH_RESPTIME option is specified in the config.inp file.
Sapcnsl can now also be used to trigger flag action for all maps, specific map or a specific device in a map.

Sathrd/Tcl Commands:
Tcl Command to enable wildcard pattern matching in XML based request/response files is now supported.

VMware vSphere API support:
Updated support for OpenInventoryViewFolder commands when used in filters.
vmlearn enhanced to learn few more browser objects.
vmedit command line utility enahnced to allow for easier editing of large data files with a specified edit command list to create new containment hierarchies.

Bug Fixes/Enhancements:
GUI dialog for Trap Generation now allows sorting and searching in the displayed trap list.
Improved handling of multiple sessions in pcap to telnet modeling file conversion.
Support for new pcapng file format added to sapt2tel, stpktcnv, supktcnv, sapp2dat, and sapp2var utilities.
Added generation of additional SNMP topology related columns and rows for LLP support to topology wizard and editor.

SimpleAgentPro/SimpleAgentEnterprise Ver 18.0 Release Notes July 15, 2014

Telnet:
The sapt2tel utility has been enhanced to decipher tcp packets from a regular pcap file and create a telnet modeling file. You can now use wireshark/tcpdump to capture telnet interaction between your application and the real device and then provide the pcap file to sapt2tel and it will create a telnet modeling file that can be used for simulation.
A new SSH client learner utility is now available that can take a list of commands to send to a real device and convert the responses to a telnet/ssh modeling file.

Netflow Version 8:
In addition to Netflow versions 5, 7 and 9 – support for Netflow version 8 has been added. This also completes the support necessary for JFlow since it includes version 8 packet format.
The Netflow editor that provides a graphical interface to create Netflow packets has been enhanced to support Version 8.
The Netflow packet converter utility has been enhanced to decode version 8 packets.
The Netflow statistics include flow count information.

CoAP support:
A separately priced CoAP module is now available to work with SimpleAgentPro and SimpleAgentEnterprise on Linux. CoAP simulated servers support discovery, multi-casting, observation and block transfers.
As part of the CoAP module, a CoAP learner that records the data from a real device is included.

XML/REST support over HTTP(s):
The proxy recording and playback feature has been enhanced to handle a variety of cases including chunked encoding.
In addition to GETs, support has been added for POST and PUT requests in both the modeling file as well as the playback file.

Sathrd/Tcl Commands:
Tcl Command to enable the checking of SNMPv3 time stamps in the case of noAuth/noPriv discovery for simulating errant agent behavior has been added.
Tcl Commands to control the CoAP response generation and behavior have been added to allow control of CoAP devices via sapcnsl and scripts.

VMware vSphere API support:
vmtree command line utility displays object containment tree in the specified data file.
vmcheck command line utility displays a list of supported and unsupported API calls, given a debug file with captured request response interaction.
vmedit command line utility allows for easier editing of large data files with a specified edit command list to create new containment hierarchies.

Bug Fixes/Enhancements:
GUI dialog to allow the conversion of Debug files to Playback files for XML simulation has been added.
Improved handling of blank lines in workspace files.
Netflow statistics can be retrieved using sapcnsl.
GUI checks with the name server process (sapns) for license information.

SimpleAgentPro/SimpleAgentEnterprise Ver 17.5 Release Notes Dec 17, 2013

HTTP/s with REST/SOAP:
Support is now included for an embedded HTTP/s server which will parse incoming http requests and look for information from a playback file or modeling file to respond to http requests. HTTPs support is currently available on Linux.
A Proxy Server is included that can record incoming requests that get forwarded to a real Server and the server response, after recording, gets returned to the requestor. The recorded messages can then be converted into a playback file or a modeling file that can be used during the simulation.
The modeling file includes support for token substitution that can be used when cloning simulated devices to give back different responses.
VMware vSphere API support with playback:
The separately priced cloud module is now enhanced to include a Proxy Server with record capability that can be used to create playback files.
The simulated vCenter is also enhanced to use playback files for simulation.
Support has been added for additional API calls such as CheckForUpdates and QueryPerfCounter.
Optimized GUI Starting of Maps:
The starting of large number of maps via the GUI has now been optimized to reduce the startup time considerably.
This time saving feature is particularly useful for large scale simulations.

User Interface:
A new icon to start a Device has been added to the toolbar.
As the Device Properties contains multiple Tabs for the various protocols supported, a drop down combo box has been added to it to facilitate quick navigation between the the Tabs.
The configuration dialog has been enhanced to allow the selection of the interface to be used for adding the multihomed IP addresses used for simulation.
Fast Stop option for all maps has been added on Linux.

Sathrd/Tcl Commands:
A new %authfailure_action callout has been added to handle tcl script evaluation upon authentication failure.
Additional XML and SOAP commands allow for the support of valuetype construct to be used to generate dynamic values in responses.
Support has also been added to handle XML Client initiation of connections for use in CWMP.
NetFlow data file now supports an optional cache count that can be used to send specific traffic cache values for a certain amount of time.
Sapcsnl has been enhanced to start all maps in a specified workspace.

License Server:
A 64-bit License server for Linux is now available.
Support has been added for a notion of User with login and password to facilitate separate pools of licenses.

Bug Fixes/Minor Changes:
Display statistics on status bar has been optimized.
Return of incorrect path from sapns when SAPro installed in a different drive other than C: has been corrected.
Saving of GUI settings in sapro.ini at termination has been updated.

SimpleAgentPro/SimpleAgentEnterprise Ver 17.0 Release Notes July 23, 2013

IPMI Management Protocol:
IPMI version 1.5/2.0 is now supported by simulated devices.
IPMI learner that will communicate with real IPMI devices and record their responses is also included. Additional commands to learn can be specified in a rules file.
IPMI modeling file is automatically created by the learner and can be edited to add support for additional commands.
The AES version of SAPro/SAEnt includes support for IPMI version 2.0 as IPMI uses AES-128 encryption. It is available on both Windows and Linux platforms.

VMware vSphere API support:
A separately priced cloud module is now available to work with SimpleAgentPro and SimpleAgentEnterprise on Linux. A subset of the most commonly used API calls is supported to do inventory, performance and event management.
A vSphere API learner, that records the data from a real vCenter/ESX server, is included and support is also provided to duplicate existing hosts and VMs.

64bit Linux version of SAPro:
With 64bit Linux becoming widely used, SAPro is now available in both 32 bit and 64 bit versions.
The dynamic libraries used by the 64bit version are also better compatible with what is natively available on the test system.

User Interface:
A command shell can now be opened in the bin directory from the tool bar and menu. The type of terminal to open can be specified in the config.inp file.
Map details of only the selected map are displayed in the main status window.
Fast stop menu is now activated on Linux that allows maps to be stopped quickly.
Display Map Statistics for all the running maps are now automatically updated.
Data file generation for the various protocols supported is now moved under a new menu item for better organization of options.

Sathrd/Tcl Commands:
Commands to close tcl/snmp debug files have been added.
Commands to add/del devices from a running map will now update the map file if option set in config.inp.
Additional TL1 Tcl commands now allow you to specify different command termination strings, starting characters for acknowledgements and spaces in autonomous messages.

Bug Fixes/Minor Changes:
IPv6 linux response port network order has been fixed.
Improved support for virtual environments with longer license keys.
Telnet statistics can now be retrieved using sapcnsl.
Dynamic buffer allocation for telnet responses is now supported for large responses.
PDF help file can now be opened from the GUI.
TL1 new line character is now fixed in response.

SimpleAgentPro/SimpleAgentEnterprise Ver 16.5 Release Notes December 11, 2012

User Interface:
When viewing a map’s log file, the view is now updated dynamically as new log entries are added.
The capability of assigning an IPv6 address to devices in the Linux version is now also available in the Windows version.
Individual devices can now be stopped and started from the toolbar.
The number of traps sent is now included in the map statistics window as well as the individual device statistics window.

License Server:
Distributed licenses now support temporary checkout of a license where runtime connection to the license server is no longer required during the checkout period.
The License Server Manager now includes a window to update the License Server key while the server is running. There is no longer a need to restart the license server.
The License Server Manager has been enhanced to include a restart license server option under the Server Management tab.
The License Status tab on both the client and manager utility has been enhanced to display the IP address for “VM” type licenses.

Sathrd/Tcl Commands:
Ability to receive the response for tcl command evaluation in another device context has been added.
Ability to receive a response for sending SNMP commands to other deviecs has been added.

Bug Fixes/Minor Changes:
Debug files are now created when a map and its associated files are located under the projects directory.
A check was added such that maps started via the sapcnsl utility are now prohibited to start via the user interface.

SimpleAgentPro Ver 16.0 Release Notes May 30, 2012

User Interface:
Enhanced debug tracing using the GUI.
Common runtime settings that are currently saved in the config.inp file, can now be specified using the GUI.
Maps and folders can now be renamed, and the map status can be reset if it fails to start.
Performance statistics can now be seen via the GUI if threshold settings are specified in the config.inp file.
Workspace creation allows the specification of the related files to be copied within the projects directory, so that it becomes self-contained.

Sapcnsl/APIs:
Devices can now be deleted from an existing map using the “deldev” command.
Support for a synchronous start of the map that returns only after the requested map is started. This removes the need of checking the status of the devices to see if they are up after starting a map.
Support for both these commands has been added to the Java/Perl APIs.

Sathrd/Tcl Commands:
Devices can be made to inject variable SNMP delay in their responses to simulate variable network load environment.
Tcl commands like SA_telnet_cleardevstring/appenddevstring/getdevstring allow the saving of telnet data across telnet sessions.
In the AES version, support has been added to accept soap requests over both HTTP and HTTPs.

Other Utilities/Wizards:
The topology editor wizard has been enhanced to allow user defined router/switch var files to give the required personality to the created topology.
sapwalk2 utility now includes support for GetBulk if requested.
SSH based command line utility is now available to learn the responses of a specified list of commands and save them in a telnet modeling file for future simulation.
MapViewer has been enhanced to display all running maps in a system and displays more details about them in the status bar. Digital signature is now included for Windows installer.

Bug Fixes/Minor Changes:
Added ability to return snmp port/name in the device list to facilitate proxy maps.
Support to log messages in one file created and maintained by sapns has been added.

SimpleAgentPro Ver 15.5 Release Notes November 14, 2011

Tcl Commands:
Support has been added for creating TCP forwarding sockets to forward requests and responses from clients to designated servers. This allows for simulation support for additional network management api support where designated servers are available.

Radius:
Linux version includes support for generating Radius client requests.

Scenarios:
Support has been added to specify radio and check box widgets when creating scenarios in addition to the existing text fields.
Tcl commands can now be directly run inside a scenario and the order of parameters can be changed.

User Interface:
Status of the devices in a map is reflected in the color of the check mark displayed next to the map.
Maps can now be stopped while starting in SAEnterprise without having to wait for all of them to start.
Support has been added to quickly open up file viewer in root and map directories.

Sapcnsl/APIs:
Show version command shows current version of the running sapns along with device count information.
Ability to quickly terminate a map (faststop) on Linux has been added to sapcnsl and Java/Perl apis.

Bug Fixes/Minor Changes:
Added ability to check additional mac addresses when validating keys on Linux.
Added additional responses for sapcnsl/api messages.
Fixed invocation of MIB Browser for proxy type devices.

SimpleAgentPro Ver 15.0 Release Notes April 12, 2011

Java and Perl APIs:
In addition to the previously available sapcnsl command line utility, java and perl packages/libraries are now also made available to ease the integration of SimpleAgentPro/Enterprise into your test harness.
All commands available via sapcnsl are now also available in the Perl and Java API. You can start/stop maps, as well as send tcl commands to specific devices.

Updated Topology Wizard:
The topology wizard has been updated to also simulate hosts if desired. It allows you to quickly create a typical router-switch-host type networks that are connected to one seed router.
VLAN support in the switches is now also available, and hosts can be optionally simulated.

Netflow Editor:
A graphical editor is now added to the Netflow simulation capability allowing you to create Netflow packets without first capturing them off the network.
Support is present for ver 5, ver 7 and ver 9 Netflow packet generation.
Please note that Netflow is an optional, separately priced module.
Map Statistics in SimpleAgentPro Map Viewer:
You can now view statistics for all maps currently running in the SimpleAgentPro Map viewer. This allows you to see, at a glance, all the simulations currently running on your system.

License Server:
License server configuration utilities have been enhanced to allow the updates of keys without requiring the license server to be brought down. License server keys as well as simulation license keys can now be more easily added and updated.

Tcl commands:
Support for additional tcl commands to ease the simulation like getting the current value type, setting the retry delay behaviour, etc has been added to the Tcl interpretor.

Bug Fixes/Minor Changes:
Token values of partial mac addresses in the Topology Data field can also get autoincremented when cloned.
Added checking to stop the starting of already started maps and devices.
Enhanced the installation process to run on Vista and Win7 with less security restrictions.
Fixed the processing of duplicate labels in sapvsort.
Updated the disabled icons display.
Rollover of 32 bit counters in SimpleAgentEnterprise has now been corrected.
Message interface has been updated to allow 32 bit and 64 bit executables to communicate with one another.

SimpleAgentPro Ver 14.5 Release Notes Sept 1, 2010

Topological Views:
The SAPro GUI is now enhanced to show a topological view of a map with connectivity information, in addition to the existing List view and Thumbnail views.
Maps generated by using the Topology Editor can have this view also displayed.
Scalable Topology Wizard:
A new wizard has been added to quickly create scalable topologies made up of a typical router-switch-host type network.
These created topologies can be “discovered” by the NMS.

Tokens:
The maximum number of tokens limitations has been increased to allow even larger usage of tokens. This can help create very large networks while using a small number of var files.

Find:
The GUI has been enhanced to include a Find feature that quickly allows you to identify which map a particular device is running in.
The same capability is also available via the sapcnsl command line utility.

Licensing:
New utilities have been added to configure the license server and also to get the current status from the license server. The utilities can be run on the same machine as the license server as well as from the connecting client/SAPro machine.

sapwalk2:
sapwalk2 has been enhanced to accept additional arguments that keep some timing information from real devices so that not just the values, but also the slowness of specific responses can be replayed in the simulator.

Tcl commands:
SA_getsnmpdelay has been added to to allow the resetting of the original snmp delay value, in the case of duplicating agent delay behavior based on enhancements in the mib walk files.

Telnet:
Support has been added to allow the enabling/disabling of echo status within a telnet session along with auto reset.

SFlow:
The separately priced Flow module can now support sFlow on an experimental basis, in addition to NetFlow and IPFIX.

Bug Fixes/Minor Changes:
sapnw2var has been enhanced to have additional arguments to support suffixes, interface names and append modes.
sapw2var can now auto determine the input walk type between NetSNMP, HP and SimpleSoft mib walk dumps.
saprqgen utility can now send v1 and v2 requests from SNMPv3 debug traces.
Start All Maps, can now be interrupted in the middle without have to wait for all the maps to finish starting.
getdiags utility script has now been added to quickly gather information about SAPro system to debug issues.

SimpleAgentPro Ver 14.0 Release Notes March 22, 2010

Starting Interface Number:
Requirement for specifying the starting interface numbers for each map on Linux has now been removed. SimpleAgentPro will automatically assign the next avaialable aliased interface number when adding devices.

Cloning:
Token file based devices can now also be cloned, and new token files with auto incremented addresses will be created for the cloned devices.
Increments for IP and Mac address can now be better specified when cloning.

Tokens:
Use of tokens has been optimized to minimize the impact on performance of dynamically substituted values for variable object identifiers as well as variable values.

Name Server Service:
Sapns, the SimpleAgentPro Name Server, can now be more easily started as a service by providing a user interface to assist in this regard. Running sapns as service, is particularly useful when using dongles in a remote desktop environment on Windows or Linux.

Licensing:
Enhancements have been made to the license server to better support VmWare based deployment. Additional licensing modes are now also available to meet evolving customer needs. Please contact Sales for more information.

Valuetypes:
Additional valuetypes like twoindexstr and enhancements to addr2str and indexmac better support range/token based large scale topology models.

Tcl commands:
SA_modifyv3userinfo has been updated to allow definition of additional v3 users when used in conjunction with SA_clonev3user.

Telnet:
Support has been added for control-shift-six-x, waiting for characters before login, and specifying usernames prior to administrative logins.

3DES:
The AES version now also adds support for Triple DES privacy protocol in addition to DES and various flavors of AES.

Bug Fixes/Minor Changes:
Better support for Web-based Help is now included for Linux versions by specifying the default browser.
Trap generation user interface has now been enhanced to support multiple traps tcl commands to be sent out for one displayed label.
Support has now been added to have SimpleAgentPro output diagnostic messages in log files when some response thresholds are exceeded to better identify bottle necks and overloading.
Debug files are now created in the sapro/debug directory.

SimpleAgentPro Ver 12.5 Release Notes Aug 6, 2009

Map Folders:
SimpleAgentPro now supports folders and subfolders within a workspace. This allows you to better organize your large collection of maps.

Netflow:
You can now specify netflow parameters when specifying device properties.
You can also generate netflow packets by right mouse clicking on a device and loading a particular data file.
Support has also been added to the Netflow simulator for ipranges and octet string valuetypes.
Supktcnv utility is now included that can convert captured netflow packets in pcap format (from WireShark) to netflow data format.
Netflow is a separately priced module.

License Server:
Support for license server has been enhanced to include support for both dongle and software keys. SimpleAgentPro running on all three platforms can now communicate with the license server. This is particularly useful when using SimpleAgentPro on VmWare machines.
Licensing checking of device count and ip count has been updated to run faster.

Tcl based HTTP Server:
Support has been added to a tcl based http server in addition to apache. You can run a separate tcl based http server and SAPro will generate configuration files for it to support the simualted devices.

Additional Variable Oid/Value Support:
Support has been enhanced for valuetypes like indexstr, indexmac, indexip to support range based oids used in scalable topologies.
A new range type using brackets “(n-m)” has been added.
Support for %sapdefine has been added to the variable file.

Tcl commands:
Support has been added for specifying response variable bindings during pdu processing.
Support has been added to specify the v4 and v6 addresses to skip when adding additional addresses.
Support has been added to retrieve dhcp information for the original device address if got through DHCP.

Bug Fixes/Minor Changes:
Trap recorder has been enhanced to also create maps so that they can be replayed more easily.
Clearing of statistics counters is now supported.
Windows Install Shield version has been updated.
Sapwalk and sapwalk2 are now being built on Linux with static linking to libraries.
Script that sets the environment variables like LD_LIBRARY_PATH to start sapro has been added on Linux.
Variable editor now skips %csibegin/end sections.
Temporary files are now created in the sapro/work directory on Linux and Solaris.

SimpleAgentPro Ver 12.0 Release Notes Jan 23, 2009

NetFlow Support:
SimpleAgentPro now supports the transmission of Netflow packets from simulated devices to create the appearance of flows. These can be used to test collectors and NetFlow applications.
Both fixed and dynamic values in the flows are supported. Netflow Version 5, 7 and 9 packets can be created.

Scenario Scripts with Parameters:
You can now specify parameters when sending scenario tcl script files to devices and maps. This allows you to dynamically specify things like interface numbers and trap managers as parameters to specific network scenario scripts.
The running scenario is associated with a specific map and its running status is reflected in the GUI.

Drag/Drop devices from one map to another:
The GUI has been enhanced to allow the movement of devices from one map to another, using the familiar drag and drop method.
Workspace level statistics window:
You can now see the statistics at the workspace level for all the currently running maps. In the past you could get only get map and device level statistics, Count of currently active telnet sessions is also shown.
Topology Editor enhancements.
Support has been added to import the interface types from the associated variable file.
You can also specify additional device properties like telnet modeling file when creating maps via the topology editor.

ProFtpd FTP Server:
Support has been added to interface with a public domain FTP server called ProFTPd, in addition to the older wu-ftpd.

Additionl Variable Type Support:
Support has been added for new valuetypes like step(start,time,increment,max) and tooth(min, multiplier, max) to better model variable behavior.

Tcl commands:
Support has been added for additional Tcl commands to change username/seclevel/authtype/privtype and passwords.
Support has been added to get the current trap manager/port and trap community string
Support for getting the device name for dhcp.
Support for getting the telnet and snmp status of a device.
Support for enabling/disabling modelling file of a device.
Support for specifying a list of IPs to be ignored when adding IP addresses from the IP Address Table.

Packet Capture Utility:
A simple utility that opens up a specified UDP port and listens to traffic and dumps out the received packet in a file is included. It can also forward the received packet to another address/port if required.

Bug Fixes/Minor Changes:
Fix for negative co-ordinates in Topololgy editor.
Non-modal debug window, and resizable Tcl Script window.
Sapns service stopped during re-installation.
Better handling of large numbers for Counter32 and Counter64 data types.
Allows dhcp based master proxies which have a device name instead of an IP address.

SimpleAgentPro Ver 11.5 Release Notes July 10, 2008

Telnet learning command line utility:
tellearn is a command line utility that given a list of commands to learn and device profile, will setup up a telnet connection and convert the telnet responses to a telnet modeling file.
The utility to convert captured telnet session text files to telnet modeling files is now called sapt2tel.

Support for Wild carding in telnet commands:
There are many commands that seem to have only one parameter different, and the responses are also same or differ with regards to that parameter. By allowingwild carding in commands, it is possible to reduce the number of commands in the modeling file, thus reducing the device footprint.

Pre-compilation of telnet/snmp modeling files:
Modpcomp is a command line utility that preprocesses modeling files. It handles both telnet and snmp modeling files. When a script is written to learn all the CLI commands supported by the box, then the modeling file can become as large as 2G bytes. For large modeling files, if they are precompiled, then the time required to start a device/map can be significantly reduced. The telnet/snmp modeling files can also be encrypted prior to distribution.

Dynamic addition of telnet command actions:
Running a telnet command sometimes can result in the device supporting additional commands as in the case of provisioning. To allow this a new tcl command SA_telnet_addcmdaction has been added to the telnet Tcl interpretor.
Support for tftp client commands in telnet session.
To allow the tftp client tcl commands to also be interpreted in a telnet session, a new tcl command has been added that enables the SA_tftpget/SA_tftput commands, called SA_telnet_addtftpclientcmds.

Timestamps in syslog:
Today syslog events are treated as a simple string. New Tcl functions called SA_getsyslogtstamp and SA_getsyslogheader that returns the timestamp in sylog format have been added to allow its embedding in the syslog string.

Router cloning with multiple interfaces:
Today SAPro allows substitution of the primary management interface with the use of tokens. But if the device has additional IP addresses, then those do not get autoincremented during cloning. To solve this issue, support has been added to use tokens for the additional interfaces also.

HTTP root directory cloning:
Today SAPro allows you to specify different root directories for different devices, so that each device can have a separate index.html file. If the http root directory of a device has its own IP addresss as part of the directory name, like “/http/10.1.1.1/htdocs”, then if that device is cloned, the root directories for the cloned devices will automatically be set to
“/http/10.1.1.2/htdocs” and
“/http/10.1.1.3/htdocs” etc…..
The actual directories and the different index.html files would need to be setup manually by the user, but the map generation part will be automated.

Support for command line learning of traps/syslog:
saptrlrn is a command line utility that opens up trap and syslog ports and listens for incoming traps/syslog events. Upon receiving them, it will convert them into corresponding tcl commands for trap/syslog generation. Typing a CtrlC terminates the running application.

Map cloning:
A map can now be cloned. The IP addresses of the devices in the original map are incremented by incrementing their subnets. Associated mac addresses, and topology data fields are also auto incremented. An option is available to add the new devices to the same map or to create new maps.

Telnet Statistics:
The Device and Map statistics now includes an option to also see Telnet statistics. Number of telnet sessions and number of CLI commands processed are counted and displayed.

Topology Editor supports additional interface types:
Topology editor now allows you to select the interface type for the interfaces instead of just ethernet(6) The different interface types are present in an editable, and user expandable list.

Topology Editor supports tokens:
Topology editor now allows you to create variable files with tokens instead of actual values, so that the configuration can be cloned with the new Map Cloning feature.

Workspaces with separate directories:
Workspaces can now be created so that they have their own subdirectories underneath the sapro/projects directory. The newly created files can all be contained underneath one root directory.

Tcl command to enable Variable Marking:
The SA_dumpgotvars command can be used to dump out all the variables that have been accessed by a manager since startup. It used to be controlled by the MARKVARSREAD = YES flag in the config.inp file. Enabling it would cause all devices to keep track of the variables being accessed. A new tcl command called SA_setmarkvarsflag has been added that allows this behavior to be controlled on a per device basis.

Sappoll to try SNMPv1 if no response received with SNMPv2c:
Sappoll has been enhanced to automatically try using SNMPv1 if no response is received from an agent by sending it a SNMPv2c request. Most of the command line arguments are also echoed in the output.

SNMP Request generation utility:
Saprqgen command line utility processes the snmp debug output and uses it as a basis to recreate the manager requests to be sent to the device. It extracts the SNMP request pdus and then recreates new requests that are similar to the original requests received by the simulated device. The command line argument allow you to overwrite the information in the request packet captured in the snmp debug file.

Telnet request regeneration:
A new debug level has been added to SA_telnet_debugflag. Setting it to 9, makes SAPro only write out the commands received. The debug file with these commands can then be given to the tellearn utility to recreate telnet commands received by the the simulator.

Stop status reflected on the GUI:
In the past, the GUI would show that all the maps have stopped, even though the maps were being stopped and cleaned up. The GUI now reflects the current status of the map/device cleanup more closely, when the WAITFORDEVICESTOSTOP=YES is enabled in the config.inp file.
Patching of timestamps in pre-created trap pdus:
To get better trap generation performance, users could create the trap pdu before hand in the init_action section via SA_trapgetpdu, and then simply send the generated packet in the timeraction using SA_sendtrappdu. But this trap packet would be the same every time and would not reflect the changing value of sysUptime. An optional second argument has been added to the SA_sendtrappdu call, that if set would cause the SAPro to partially decode the pdu and then patch the sysUptime value in SNMPv1, v2c and v3 (noAuth/noPriv) packets.

Token processing optimization:
Previously, when tokens were used in var files and they were part of table with very large number of rows, the time required to start devices and process get-next requests would be very large. The token substitution process has been optimized for better performance.

Tcl version upgrade:
The Tcl interpretor has been updated from Tcl 8.3 to Tcl 8.4.18 It will inherit all the updates and changes made to Tcl since Tcl 8.3

Bug Fixes/Minor Changes:
TFTP client software would loop on receiving an ICMP error when trying to connect to a Windows 2003 server which did not have the TFTP service running.
SAtcmd() variables were not getting cleared.
Line numbers used in error messages by sapw2var were not correct.
Sapvsort did not handle %csibegin sections correctly.
Telnet debug file name did not allow creation in different directory.
Glibc errors displayed during stopping telnet maps on Linux have been minimized.
Command actions in scripts are now being saved for future use.
SA_getipdifference command has been added to give index of cloned device.
Removal of IP addresses on Linux has been optimized.
Mapviewer statistics display order has been corrected

SimpleAgentPro Ver 11.0 Release Notes Jan 18, 2008

User Interface:
Cloning and Optimization User interface has been enhanced and speeded up to allow faster cloning and map breakup along with display of a progress bar. Topology Editor has been enhanced to allow selection of overlapping links.

Community String Based Indexing:
Support has been added to allow community string based indexing within one device context and one variable file.
Sapwalk2 automatically learns additional vlan instances when learning from Cisco devices that support community string based indexing.

Telnet Learner Utility:
A new command line utility has been added that takes a captured telnet session text file and converts it into a SimpleAgentPro telnet modelling file.

Licensing:
Support has been added for license server based licensing in addition to software keys and dongles. SimpleAgentPro will attempt to connect to a license server running on a specified Windows machine on the network and get a license token from it. This option could be useful for installations on VmWare machines.
Software key license checking on Linux platform has been speeded up.

Device Library:
Support has been also been added for devices from vendors like Alcatel, Avaya, Airespace, Nokia, Nortel, Enterasys, Sun, Extreme and others.

Other Enhancements:
Added support for getting NTP time via Tcl commands.
Added support for optional polling cache.
Added support to get map name, and source IP and port for async udp socket calls via tcl commands.
Fixed issues with SA_setvaltype only working with certain datatypes.
Fixed issues with large initial values ( greater than 2^31 ) for Counter, Gauge, Timetick datatypes.
Sapwalk2 will try using SNMPv1, if initially set to use SNMPv2 and original request times out.
Added support for SNMPv3 configuration tcl commands to support USM key change.
Added support for retrieving logged in user name for a telnet session.

SimpleAgentPro Ver 10.5 Release Notes June 12, 2007

These notes describe the new enhancements made to the SimpleAgentPro since Version 10.0 (November, 2006)

Toplogy Editor
The Topology Editor has been enhanced to include support for switches and PCs. Now a network made up of routers, switches and end stations can be drawn and their linkages will get represented in MIB2 and BridgeMIB data supported by the individual devices. A management application can then query the individual devices to discover the connectivity.
It is also extensible to include additional “topology to MIB data” conversion rules.

Scenarios
Added support for Scenarios, where map or device level scenarios can be added and then invoked with a mouse click from the pop-up menus associated with maps or devices.
Engineers in the pre-sales or engineering departments can create scenarios that sales and marketing people can quickly and easily use to create network events that showcase the capabilities of your management application.
Test engineers can also run pre-created scenarios during regression testing.

Polling Support
A new utility called “sappoll” has been added which takes multiple snapshots of specific variables and records them in a file so that they can be replayed later.
This is particularly useful in learning new device data from customer sites, and then recreate customer environments in labs.

Other Enhancements
Added support for creating simulated devices without SNMP.
Added support for ssdiscover to get entity mib information.
Added support to get topologydata via tcl commands.

SimpleAgentPro Ver 10.0 Release Notes November 14, 2006

These notes describe the new enhancements made to the SimpleAgentPro since Version 9.5 (April, 2006)

Management Applications
Added Wizard support to import managed devices from Network Management applications.
Given a list of devices and their SNMP profiles, SimpleAgentPro can quickly learn their SNMP variables and create maps that duplicate the production network in your lab environment.

IPv6 DHCP/TFTP/TOD
Added support for DHCPv6 in the unrestricted Linux version of SimpleAgentPro. You can now create both statically defined IPV6 devices and have it make DHCPv6 requests to get addresses.
DHCP requests can be made both sequentially and in parallel.
Once the address is received, it can be followed up with TFTP and TOD requests over IPv6.

Advanced DHCP Support
GUI support is now added for DHCPv6 option specification

Map Viewer
A graphical map viewer application is included that provides a view into all the maps currently running on the system. These include maps started by other users.
The map viewer only allows a “read-only” view of the maps. You cannot stop a map started by others.

CastleRock SNMPc Wizard
Added support to work with CastleRock SNMPc to import device list for simulation.
MIB complier interface
Added a new interface for MIB compilation. The user interface has been changed to show a list of currently compiled MIBs along with the Modules inside them. The MIB compiler now supports auto resolution of imported objects from MIB files present in specified directories.

Agent
Added support for AES as a SNMPv3 privacy protocol in addition to DES. This support is available in the US version.
Added support for parallel DHCP request to be sent via Tcl commands.

Other Enhancements
Added support for SSH Directory specification to supprort SCP on Windows.
Added support to optionally return NO_SUCH_NAME error when doing sets with a read community.
Added a SA_checkstopflag Tcl command to stop forever loops.

SimpleAgentPro Ver 9.5 Release Notes April 17, 2006

These notes describe the new enhancements made to the SimpleAgentPro since Version 9.0 (July, 2005)

Traps 
Added GUI support for a device to generate traps in bursts as well as periodically.
Added GUI support for all devices in a map to generate traps in bursts as well as periodically.
Previously this functionality was available via scripting but not via a GUI interface.

IPv6
Added support for IPv6 in the Linux version of SimpleAgentPro. You can now create statically defined IPV6 devices and have them support SNMP. This capability is only available in the unrestricted version.
You can learn SNMP variables from IPv6 devices, and the simulated IPv6 devices can emit traps to IPv6 managers.

Advanced DHCP Support
GUI support is now added for DHCP option specification as well as unicast/broadcast/relay capabilities, allowing SimpleAgentPro to be more easily used in testing provisioning applications.
The Cable Wizard is also now enhanced to provide these capabilities.

Modeling File Editor
A graphical modeling file editor is provided to assist in the creation of Tcl based modeling script files. Inclusion of Tcl commands and their arguments can be carried out by filling information in associated dialog boxes.
Template modeling files are also provided.

SAPro Name Server as a Windows Service
The sapns name server can now be installed as a windows service facilitating the use of dongles in a remote desktop environment.

CA Spectrum Wizard
Added support to work with CA Spectrum to import device list for simulation.

Agent
Added support for context engine id based proxy scheme in addition to the already supported context name based proxies.
Added support for stopwatch style Tcl commands in the modeling file.
Added support for additional telnet commands to get userdata information.

Other Enhancements
Added support for associating a customized logo image with each device.
Added support to sort displayed devices and maps in the GUI.
Added support to show “Total” in the statistics window.
Added support to sapwalk utility to limit number of instances and rows learnt.
Added support to sapcnsl utility to add devices to a running map and to start/stop/restart individual devices.

SimpleAgentPro Ver 9.0 Release Notes July 15, 2005

These notes describe the new enhancements made to the SimpleAgentPro since Version 8.5 (October, 2004)

TL1
Added support for TL1 learner to convert TL1 log files into TL1 modeling files for use with the TL1 simulator. Support was also added for many Tcl commands related to TL1 like SA_TL1_setauto_atagformat to allow better simulation.
An asynchronous UDP socket can also be opened within a TL1 session to receive Tcl commands during a client connection.

Telnet
Added support for additional Tcl commands to provide default command action, disable processing, add delay, skip processing, skip initialization sequence, and deal with different types of input terminator sequences.
Added asynchronous UDP socket support to process Tcl commands in a telnet session.
Made the max number of simultaneous sessions configurable.
Allowed support for multiple usernames and passwords.

Graphical Topology Editor
A graphical topology editor is provided to assist in the creation of gateway files that are converted to corresponding variable files with appropriate MIB2 data.
Workspace and maps can also be automatically generated.

Dynamic row templates
Rules file syntax has been enhanced to allow automatic enabling of row status tables and making all columns not required.

Agent
Added support for Tcl based commands to give provide an aynchronous interface for handling message callbacks on a specified UDP port.
Added support for short definite form encoding of SNMP packets.

Other Enhancements
Added support for converting Concord’s walk files in sapw2var.
Added fix to resolve zombie process creation on Solaris 2.8 and incorrect packet tracing of report PDUs.

SimpleAgentPro Ver 8.5 Release Notes October 15, 2004

These notes describe the new enhancements made to the SimpleAgentPro since Version 8.0 (Feb, 2004).

Wizards
Added support for HP OpenView Discovery Wizard that discovers, learns and creates simulation maps based on information in HP OpenView database.
This greatly simplifies the tasks of duplicating existing networks instead of just duplicating individual devices.

MIB Browser
The MIB Browser has been enhanced to show changes in data as well as show results in multiple windows. The preferences dialog allows the user to save these settings for subsequent use.

MIB Compiler
A less stringent MIB compiler is now included with the product. The older mibcompiler is also provided for backwards compatibility if required. It uses a best-effort approach to parsing the MIBs and extracts as much information as possible from it.

DHCP
DHCP requests can now also be made in parallel instead of sequentially as done in the past. This allows the simulation to stress DHCP servers with many requests coming all at once.

MIB Based Learning
In addition to doing snmp walks to learn all the variables supported by an agent, learning can also be restricted to learn only those variables that are present in a specified MIB. Number of rows learnt from a specific table can also be curtailed.

Agent
Added support for Tcl based commands to give current snmp port information as well as currently processed object identifier (which for getnext requests might be different than the one in the request).
Added support for automatic mapping of $$MYMAINMACADDR$$ token in the variable file with the device’s associated MAC Address.

Command Line Utilities
Added support for carrying out learning on HP OpenView machines that are not running SimpleAgentPro. These tools can then be taken to customer sites to quickly build list of devices to learn from.

SNMP Informs
Added support to provide SNMPv3 discovery based inform generation and retransmission until response/ack is received from the inform receipient.

SimpleAgentPro Ver 8.0 Release Notes February 18, 2004

These notes describe the new enhancements made to the SimpleAgentPro since Version 7.5 (July 28, 2003).

Wizards
Added support for Discovery Wizard that discovers, learns and creates simulation maps based on seed router, subnets, and IP ranges.
This greatly simplifies the tasks of duplicating existing networks instead of just duplicating devices one at a time.

SSH
The Telnet/CLI interface in SimpleAgentPro is now also available via SSH, as today’s secure devices increasingly support SSH instead of Telnet. Users can now login into the simulated devices using SSH and run CLI sessions.
Multiple SSH sessions are supported to the simulated devices and pre-learnt CLI responses can be played back over SSH.
SSH support is currently only available on Solaris and Linux within United States. It is not currently available for export.

HTTP/HTTPs
Simulated devices now support HTTP/HTTPs in addition to SNMP, SSH, Telnet/CLI, TL1, FTP and TFTP. Now, some management data can be retrieved via SNMP while other data can be got via HTTP/HTTPs.
SimpleAgentPro also includes a simple HTTP learner application that allows you to learn from existing devices and save their HTTP responses so that they can be replayed later.

Agent
Added support for Tcl based command to automatically add trap recipients from the SNMPTargetAddrTable data.
Added support for manipulating the object ids returned in SNMP Set responses.
Added support to specify additional varbinds in enterprise specific traps when creating traps from MIBs.

Command Line Utilities
Added support for carrying out SNMP walks in parallel to facilitate faster learning from existing networks at customer sites.
Added support for discovery tools that can be taken at customer sites to quickly build list of devices to learn from.
Added support for learning traps for various trap logs.

User Interface
Added support for graphical display of maps using images.

Telnet Learning
Added support to handle cases where special input is necessary before the login prompt is displayed.

SimpleAgentPro Ver 7.0 Release Notes March 14, 2003

These notes describe the new enhancements made to the SimpleAgentPro since Version 6.0 (August 2002).

User Interface
New user-interface introduces a notion of servers within workspaces. Maps on remote servers can be started/stopped supporting an enterprise level distributed simulation environment.
New user-interface adds a thumbnail view of the devices in the list for easier identification of different vendor boxes.
Added support for user defined names for the simulated devices.
Added support to select different workspaces. Now different users can have different workspaces that can be saved and loaded, thus preserving different test configurations.
Added support to display trap and syslog statistics in addition to get/set packets statistics in the device statistics window.
Added a TL1 modelling file editor that can assist in creating TL1 modelling files for simulating TL1 supported devices.
Added support for SNMP debugging window to facilitate examination of SNMP requests received and responses sent by simulated devices.
Device Library Added support for user defined devices to be added to the device library. Vendors, device types and actual devices can be easily added to the device library allowing users to create a representation of all the different devices in their network.
Added support for associating vendor icons with the device library for clearer identification of the devices in a map.

Traps/Syslog
Added support for generation of syslog events from the simulated devices.
Added support to learn traps and syslog events from a real network and to record the traps and syslog events with timing information for subsequent playback of events from multiple devices.

MIB Browser
Added support to include a MIB browser within the SimpleAgentPro application to enable sending SNMP requests to the simulated devices from within the SimleAgentPro itself.
MIB Browser supports gets/sets and displays tabular instances in a table format based on the associated MIB information.
Support is also provided for adding rows to tables, multi variable operations, and redoing past query.

Agent
Added support for DHCP relay and DHCP requests for additional devices using new Tcl commands.
Added support for Diffie-Hellman kickstart initialization.
Added support for Diffie-Hellman key change via Tcl modelling files.
Added support to restart a device and make it go through the initialization once again.

SimpleAgentPro Ver 7.5 Release Notes July 28, 2003

These notes describe the new enhancements made to the SimpleAgentPro since Version 7.0 (March 2003).

Wizards
Added support for Cable Modem Wizard that takes information from the user about different types of Cable Modem and Cable Modem with MTA simulations, and translates that information into maps, modelling files, variable files etc that are required by SimpleAgentPro to support the specific simulation.
Different projects for CM and CM/MTA can be created that support DHCP, TFTP, ToD, Informs, and downloading of TFTP files based on SNMP set requests to recreate initialization packet flows as specified in the PacketCable specifications.

User Interface
Added support for sequential starting of multiple maps, instead of all at once as is currently supported, based on config file option.
Added support for status update of stopping of maps based on config file option.
Added the specification of Cache size and Dynamic instance size per map instead of a global setting in the configuration file.
Increased supported size of Topology Data field to 1000.
Increased supported size of User Data field to 1000.
Added support for viewing the files in addition to browsing when specifiying properties of devices.
Added support to create v2Inform, v3notifications, and v3 informs in the createTraps from MIB interface.

Device Library
Added support for CMTS, CM and MTA devices from Motorola and RCA.

Agent
Added support for automatic discovery of simulated subnets by supporting a router agent on the machine on which the simulation is running whose MIB-II data will point to the various simulated devices.
Added support for adding tokens in the variable file which are substituted with device specific information from the Topology Data field on the Device. This allows you to share one variable file with many devices and yet have some specific data overwritten within it at runtime from information that is associated with the device in the map file.
Added support for specifiying end of line character sequences in telnet for better integration with applications.
Added support for accepting v2 datatype keywords like Counter32, Integer32, Gauge32 and Unsigned32. Support for the underlying datatypes like Counter, Integer and Gauge was already present.

Flash Demo
Added support for flash tutorials that introduce the user to the various aspects of SimpleAgentPro and help in quickly getting them started. The audio-visual tours show GUI interactions with annotated voice that guide the user in carrying out the commonly required tasks.

Web Help
Added support for Web based help for the entire documentation. The help system can now be searched much more easily.

SimpleAgentPro Ver 6.0 Release Notes August 20, 2002

These notes describe the new enhancements made to the SimpleAgentPro since Version 5.5 (March 2002).

User Interface
New user-interface introduces a notion of workspace and allows multiple maps to be started and stopped through one GUI.
New device definition screen allows the different aspects of device behavior like IP, SNMP, Telnet/CLI, TL1, TFTP and FTP to be more easily defined.
Added support to choose from pre-learnt device library for the selection of compiled mib file and variable files.
Added support to edit/view any file by invoking an editor of your choice from the SimpleAgentPro menus.
Added support for graphical variable file editor that allows you to add/delete/edit instances and their values and see them in a MIB tree format.
Added support to associate starting interface numbers and setup files during map definition itself.

Agent
Added support for dynamically mapping list of IP address tokens specified in the variable file as $$MYIPADDRnnn$$ to a list of addresses specified in the map. This allows topology relationships to be maintained even when different simulated adddresses are specified.
Added support for SA_telnet_getsnmpval function to provide tighter integration between SNMP and Telnet.
Added support to display manager ip address in SNMP debug messages.

Traps
Added support for trap learner application that can open up port 162 and listen for traps and translate them to SimpleAgentPro Trap tcl commands.
Added support to send traps via a GUI that shows a selection of trap names that are read from a Trap tcl file.
Added support for SA_trapgetpdu, SA_v2ctrapgetpdu and SA_sendtrappdu to allow faster generation of pre-built traps.

Help System
New HTML based help with dialog box pictures.
Contents are now searchable and displayed in a modeless, re-sizeable dialog box.

SimpleAgentPro Ver 5.5 Release Notes March 28, 2002

These notes describe the new enhancements made to the SimpleAgentPro since Version 5.0(November 2001).

Agent
SimpleAgentPro adds support for TL1. Management applications can now talk with simulated devices via SNMP,Telnet and TL1. TL1 is supported over Telnet.
%after_snmp_response entry points added to agent modelling file. This allows packets to be sent after the SNMP response is sent to the manager.

User Interface
Removed the restriction of starting all the devices when starting a map. Now, user can specify a subset of devices to start.
Added support to add/delete/start/stop/enable/disable/restart a group devices at the same time in a running map.
Added support to learn Telnet/CLI from a device by using a built-in Telnet Learner application.

SimpleAgentPro Ver 5.0 Redhat Linux Release Notes February 12, 2002

The SimpleAgentPro ver 5.0 is now available on Redhat Linux 7.2 in addition to Solaris and Windows NT/2000/XP.

All the capabilities of the SimpleAgentPro including Telnet/CLI are available on the Redhat Linux (7.2) platform allowing our customers to leverage the performance and cost benefits of the Intel platform with the familiarity of the UNIX environment.

SimpleAgentPro Ver 5.0 Release Notes November 26, 2001

These notes describe the new enhancements made to the SimpleAgentPro since Version 4.5(August 2001).

Agent
SimpleAgentPro adds support for Telnet/CLI. Management applications can now talk with simulated devices via SNMP and Telnet. The Telnet/CLI module is currently available at no extra cost.
Added support to create packet tracing in addition to pdu tracing.
Added support to return Tcl command results in saproapi message format.
Added support to create log files with appropriate read permissions.
Added support for Tcl commands (SA_debugmask and SA_debugputs) to allow optional tracing of user defined scripts.

User Interface
Added support to add/modify/delete devices in a running map.
Added support to start/stop/enable/disable/restart individual devices in a running map. The map now also shows individual device state.
Added menu item to open debug files.
Added support to use SNMPv3 in addition to SNMPv1 and SNMPv2C when learning variables from a real device.
Added support to create SNMPv1 Traps, SNMPv2c Notifications and SNMPv2c Informs during the creation of traps from MIB.
Added support to learn traps from a device, by using a built-in Trap Learner application.
Added support for optional dependency information file during MIB Compilation.

General
Added a telnet learner application.
Added a network discovery application.
Added support to start maps via the sapcnsl application.
Added a saptclsh application that is a Tcl shell with built-in telnet and network discovery support.
Added support for SNMPv3 in the sapwalk2 utility.
Added over 2000 MIBs to be shipped with the SimpleAgentPro as a separate MIB installation. MIBs from the IETF as well as various vendors are included.
Added a device library that includes pre-learnt devices from Cisco, Juniper, Brocade, Riverstone, Extreme and others.

SimpleAgentPro Ver 4.5 Release Notes August 24, 2001

These notes describe the new enhancements made to the SimpleAgentPro since Version 4.0(December 2000).

Agent
SNMPv3 Auth/Priv support added in the US version.
Added support for devices to make DHCP requests to get their initial IP Addresses.
Added support for nullvalue() value type and SA_NULLVALUE token in SA_setcurvalue.
Added support to generate authorizationError for SNMPv2C with invalid community strings.
Added support to append instances to oids of varbinds in trap templates.
Added support for specifying multiple read/write community strings.
Added support for trafficpercent valuetype.
Enhanced indexvalue valuetype.

User Interface
Added menu item Device->Start and Device->Stop to start and stop individual devices without bringing the entire map down.
Added menu item to edit/view trap tcl file.
Added support for extended MIB list selection on both Windows and Solaris.
Added support to overwrite existing Tcl scripts in Device->Tcl Script window.
Reduced size of device definition dialog box on Windows to support 800*600 resolution.

Tcl Commands
Updated Tcl interpertor to 8.3 version.
Added support for FTP client tcl commands.
Added support for TFTP client tcl commands.
Added support for ToD tcl commands.
Added support for SA_sendv2cinformWaitForResponse.
Added support for SA_sendv3notify and SA_sendv3inform.
Fixed problem in reading values for valuelistinfile.
Frequently asked questions section updated with sample scripts and solutions for quick answers.

General
Added support for tftp server module for both Solaris and Windows.
Changed file handles to unbuffered i/o for modelling and debug files.
Added locking for ftp server configuration file on Solaris.
Added support for running multiple instances on Windows.
Eased limitation of 50 devices per map to over 100 on Solaris.
Fixed issue with setting long value strings via SA_setvar.
Fixed issue with receiving Auth packets when in noAuth/noPriv mode.
Fixed issue with handling obsolete MIB objects.
Fixed display of noSuchInstance/noSuchObject/endOfMIBView in the packet dump.
Fixed issue with error recovery from error in variable file.

SimpleAgentPro Ver 4.0 Release Notes December 22, 2000

These notes describe the new enhancements made to the SimpleAgentPro since Version 3.0(March 2000).

Agent
SNMPv3 Auth/noPriv support added. Supports both MD5 and SHA Authentication.
Initial engBoots in simulated SNMPv3 devices is computed in 5 min increments instead of always being zero.
Added support for automatically replacing learnt device’s IP address with the simulated device’s IP address.
Added support for associating multiple IP addresses with the same simulated device for router type devices.
Added support for onerandomup valuetype to make the variables accessed in one PDU to have the same basic rate of change.
Added support for tftp server to the SimpleAgentPro.
Corrected transmission of wrongDigest and notInTimeWindows Report PDU’s, and cleared report flag in responses to work with Brass stack.
MTU Size can now be changed on Windows NT upto 2000.
Fixed error in GetBulk response length computation for SNMPv3.
Request ids are incremented for v2c traps and informs generated.

User Interface
Added menu item Device->Restart to allow individual devices to be restarted without bringing the entire map down.

Tcl Commands
Added command to set the delta multiplier for Counter type variables to globally change their rate of increase.
Added commands to add and delete ipaddresses to support devices with multiple ip addresses.
Added commands to reload variable and modeling files for individual simulated devices.
Added commands to register and deregister tftp server registration.
Added commands to get and set community strings.
Added command to retrieve the last returned value without affecting the current value of the variable.
Frequently asked questions section updated with sample scripts and solutions for quick answers.

General
Windows NT/2000 version now supports software based licensing in addition to hardware dongle based.
Support for Solaris 2.8 to take care of different multi-homed support within it.

Utilities
saptraps utility has been enhanced to generate v2c notifications and informs in addition to v1 traps.
sapw2var has been enhanced to also convert HP Openview walk output.
sapwalk2 has been added to walk using SNMPv3.
sapgwvar has been added to create gateway variable files for supporting a specified network topology. This allows auto discovery of simulated devices.

SimpleAgentPro Ver 3.0 Release Notes March 14, 2000

These notes describe the new enhancements made to the SimpleAgentPro since Version 2.0(June 1999).

Agent
SNMPv3 noAuth/noPriv support added.
NT version now supports both Microsoft TCP/IP stack and SimpleSoft’s UDP/IP stack for multihomed IP. SimpleSoft’s UDP/IP stack is now enhanced to support upto 4000 IP addresses.
Variables can be optionally stored in memory for better performance. Fixed range style instances can be used for very large table simulation.
%stop_action and %before_snmp_request entry points added to agent modelling file.
NOSUCHINSTANCE, NOSUCHOBJECT, ENDOFMIBVIEW values can be returned via SA_setcurvalue.
Maximum number of variables in a request can be set to generate TOO_BIG_ERROR, in addition to the MTU Size.

User Interface
Status window added to the Device->Tcl Script screen to see if the command was successfully evaluated. Status window also added to the Map->Setup screen.
Environment variables supported to override default directory structure.
Log files created in a separate log directory, and a file viewer added to menu.
Sathrd and sapns processes no longer show on the task bar for Windows NT.
Statistics window also shows how long the map has been up. The counter refresh rate can be controlled by a variable in the config.inp file.

Tcl Commands
SNMPv2C Informs can now be generated by SA_sendv2CInform tcl command.
SNMPv3 parameters like engineBoots, engineTime, and counters for various report pdu related errors can be got and set.
Table instances can be directly manipulated to speed up deleting and adding of rows.
Variables that have been accessed can be dumped to a file.

General
Traps get logged in the SNMP debug file.
Better resolution of timestamps in the debug file, along with support for only dumping error pdus.
XML like map file format. Older map file format still supported.
Number of rows learnt can be restricted to speed up learning.
Frequently asked questions section updated with sample scripts and solutions for quick answers.
Corrected instance value extraction during dynamic row creation of fixed length octet string indexes.

Utilities
Stand alone command line utilities provided for all the functionality of the SimpleAgentPro GUI console. sapm2var, sapdrow, sapvsort utilities added.
Sapwalk utility improved to handle errors and hidden subtrees.

SimpleAgentPro Ver 2.0 Release Notes June 14, 1999

These notes describe the new enhancements made to the SimpleAgentPro since 1.5 version (Feb 1999).

User Interface
Devices can be easily cloned via the GUI, to make multiple copies of a selected device and different IP Addresses can be assigned to them.
Tcl commands can be now be sent directly to the selected device, without going through a setup file Individual statistics can also be obtained for a selected device.
Trap tcl file containing sample tcl commands to emit traps for a given MIB file, can now be created from the GUI.
Command line option to automatically start maps when using SimpleAgentPro GUI.
Automatic refresh of statistics every 10 seconds.

Tcl
The main tcl interpretor has been upgraded to tcl8.1.
A number of device and map specific tcl commands have been added that allow the control of SNMP response error status, updating of timer delay, getting access to device settings, and issuing system commands.

General
The MIB compiler has been made less stringent, allowing MIBs to be compiled more easily.
Learning from device can be done using SNMPv1 or SNMPv2C protocol.
New valuetype allows better support for regression testing.
Fixed range support added for faster implementation of large tables.

Utilities
Console utility called “sapcnsl” can be used to control and get status information from running maps. New SAPro name server (sapns) helps in tracking multiple map invocations.
Sapcnsl works across platforms and can communicate and control SimpleAgentPro invocations on both NT and Solaris.
Sample shell scripts provided to ease the simulation of hundreds of devices, via command line. Utilities include scripts to start multiple maps, and stop them.
New command line utility called “sapcomp” allows the precompilation of variable files.

SimpleAgentPro Ver 1.5 Release Notes February 1, 1999

These notes describe the new enhancements made to the SimpleAgentPro since 1.4.7 version (May 1998).

MIB Compilation
The list of selectable files is no longer limited to file names that end with “.mib” and that are only located in the sapro/mib directory.
An “Error Log” button has also been added that allows for quick viewing of the problems encountered during the last MIB compilation.

Proxy Support
In order to provide a more flexible environment for simulating proxy devices, the SimpleAgentPro now supports multiple master proxy devices. This allows for the simulation of multiple devices that implement the Entity MIB.

Tcl
The main tcl interpretor has been upgraded to tcl8.0. The argument parsing routines has also been cleaned up and are no longer extremely sensitive to spaces and lack thereof.
A number of device and map specific tcl commands have been added that allow the control of ping status, row visibility, dynamic addition of devices to the running map, and the sending of UDP packets.

General
The MAPTCLSCRIPT setup file processing has been moved to a separate thread to prevent other threads from being blocked.
The Solaris version will now start devices much faster than before because of a change in the way in which the devices are invoked.
Trouble shooting hints have been added to all the error messages, and the error messages are all collected in one log file.
The UDP/IP stack on Windows95 and WindowsNT has been updated with all the latest fixes.

Shell Utilities
A few shell utilities have been added to the general release that help you create trap generation tcl commands based on TRAP-TYPE macro definitions in the MIB (saptraps), do SNMP walks on command line without using mib files (sapwalk) and then converting the walk output into a variable file format (sapw2var).

Message API’s
The message format of communications between the sathrd and sapro processes has been exposed to allow customers to create their own sapro like gui front ends.

Bug fixes
Randomup and random were limited to a max of 64K increments only.