Releases¶
StratoWeave releases are available on GitHub.
Unreleased¶
Core¶
- Transform actors can write their output to the layer below at any time
with
write_output, each write in its own transaction. Enable it withsw:direct-outputundersw:transform. The transform function then gets the output written last,prev_output, and should return what the actor would write for its input, so a recompute keeps the actor's output. A write is replayed after a conflicting commit.fleetmgr.cfs.UpgradeCampaignTransformis an example. #698 #783 - A transform's output replaces the configuration it wrote before, instead of being applied as a diff. Fixed source deletion, concurrent edits, restored list membership and subscriptions on newly committed list elements. #680
- A full configuration replacement, like a transform's output, skips list elements and container children that are the same node as in the last replacement committed from that source. They get no transaction, lock or commit, and their transforms don't run. An equal value in a newly built node is not skipped. #731
- A session commit reports
doneandcompleteonly after every transform below it has committed. Before, a link subscriber could commit without its linked input. #685 - Fixed a deadlock in
update_dynstatewhen the root transform was blocked on aget_datacall to the same transaction. #675 - Optional parameters declare explicit defaults, which newer Acton versions require. The transform generator emits them too.
- Child processes, environment variables and stdin go through the
Envservicesenv.process,env.varsandenv.stdio. #704 - Fixed the etcd store leaving a request without a result when etcd answers with an HTTP error whose body is not UTF-8. #724
- Fixed subscription data running in the actor of the device adapter or TTT
layer that delivered it, when the consumer passed its own actor method.
declare_subscriptions()ofDeviceMgr,ttt.Layerandadapters.adapter.DeviceAdaptertakes the data callback, and the layer'sdelta, as an action instead of a proc. #763 - A software adapter has a static
prepare_estimate(): the seconds the copy of the image takes, for planners. The IOS XE adapter gives 130. The unusedestimate(staged)is removed. #784 - Reads of a transform's data no longer copy each list entry to add its keys when the entry already has them. In Fleet Manager with 10,000 devices, a read of the fleet configuration takes 37 ms instead of 45 ms. #815
- Acton library modules such as
json,httpandargparseare imported fromstd, as Acton moves them out of base acton#3410. #833
Northbound APIs¶
- Fixed NETCONF
<get-config>returning the operational state published by transforms. #683 - RESTCONF supports the
contentquery parameter on GET. #686 - RESTCONF supports the
fieldsquery parameter on GET, which narrows the reply to the selected nodes, likeGET /restconf/data/demo-fleet:device=cpe-16?fields=software(target;state). The reply for a list entry keeps its keys./restconf-state/capabilitieslists thefieldscapability. An invalidfieldsvalue,fieldson any method other than GET, and a query parameter given twice get 400 Bad Request. #805 - Fixed RESTCONF GET, NETCONF
<get>and yang-push filters that could not reach an operational subtree under a config node, like/software:software/upgrade-campaign=foo/statein fleetmgr. #677 - Fixed
/restconf-state/capabilitieslisting YANG modules next to the RESTCONF protocol capabilities. #676 - RESTCONF replies use compact JSON and XML.
ncurloutput and the/device/<name>/target,/runningand/diffinspection endpoints are still indented. #684 - The
/layer/<idx>inspection endpoint takes the samecontentquery parameter, so it can return a layer's operational state too. #736 - The NETCONF server serves the YANG library at
/yang-libraryand/modules-state. Besides the modules of the CFS schema, it lists ietf-subscribed-notifications and ietf-yang-push as implemented, with the featuressubtree,xpathandon-change. The<hello>has oneyang-library:1.1capability instead of a capability per module. RESTCONF serves/modules-statetoo. #716 - The NETCONF server serves
<get-schema>(RFC 6022) for each module and submodule of the CFS schema, of ietf-yang-library, and of the modules that the server implements itself and their imports. The YANG library lists ietf-netconf-monitoring as implemented. #820 - The NETCONF server serves RFC 5277
create-subscriptionand advertises the:notificationand:interleavecapabilities. Application code sends a notification to the subscribed sessions withpublish()onNetconfServer.event_hub(). There is no replay yet, and a session with an RFC 5277 subscription cannot also hold RFC 8639 subscriptions. #752 - The
/device/<name>/modulesand/device/<name>/infoinspection endpoints give the adapter of each module. #756 - A NETCONF
<edit-config>transaction is complete once it is committed to TTT and persisted. Device interaction is left outside the transaction, so the edit no longer waits for the devices to apply their configuration. Before, a device that never connected kept the transaction from ever completing, and since a Fleet Manager top sends one edit at a time to each flotilla, a single such device blocked all further configuration to its flotilla. #792 - The HTTP server sends embedded static assets unchanged as bytes, so an
application's web UI can include images, fonts and other binary files,
which are served with their content type.
stratoweave.main()takesstatic_assetsasdict[str, bytes]instead ofdict[str, str]. - The HTTP server compresses text responses, such as RESTCONF and HTTP API
replies and the web UI's files, with gzip or deflate when the client
accepts it in
Accept-Encoding. In Fleet Manager with 100,000 devices, the 14 MB fleet list goes out as about 1.3 MB. #832
Devices & Adapters¶
- SNMP device adapters are generated from MIBs. The system generator
translates the MIBs to YANG and generates Acton types and subscription
paths from them. Transforms choose the polling period, and the SNMPv2c
adapter uses
credentials/passwordas the community. Mini has an exampleietf_snmpdevice type with SNMPv2-MIB and IF-MIB. See the SNMP devices reference. #701 - Device and software adapters get the
Envinstead of aTCPConnectCap, so they can use other transports, like UDP for SNMP, or start subprocesses. #702 - Each device publishes its operating system family, release, chassis model
and serial number under
state/platform. A platform probe reads them on every connect and after a software install. There are probes for IOS XE, IOS XR, Junos, SR Linux, SR OS and ArcOS, and an app sets its probes withplatform_probesin itsdevice_types.act. See the device platform reference. #712 - Transforms can subscribe to a device's YANG event notifications with
declare_notif_subscriptions()on theDeviceMgr, naming them inNotifSpecs. EachNotifEventcarries the event time, the payload decoded against the device schema and the raw XML. The NETCONF adapter uses RFC 8639establish-subscriptionon the main session where the device supports it, and otherwise an RFC 5277 subscription on a session of its own. Delivery is at most once, with no replay. Pass asyncedaction to learn when the subscriptions are in place, before sending an RPC whose result arrives as an event. See the event notifications reference. #752 ncurl notificationsprints the event notifications a device sends, all of them or those named with--notification module:name, and how the adapter subscribed to them. #752- When a device advertises
ietf-netconf-notifications(RFC 6470), theDeviceMgrsubscribes tonetconf-config-changeand resyncs the device's running configuration when one arrives. A change made outside StratoWeave is found without waiting for a reconnect. StratoWeave's own commits cause a resync too, because theDeviceMgrdoes not checkchanged-by. #753 adapters.iosxe_cli.IosXeCliAdapterruns IOS XE commands over SSH, for what NETCONF lacks on a device, or on older releases where NETCONF does not start at all. It returns what it reads in thestratoweave-iosxe-cliYANG module: the files on a file system fromdir, the release, model, serial number and boot image fromshow version, and the output ofshow install summaryandshow bootvar. A device type that uses it addsadapters.iosxe_cli_yang.modelsto its schema. #755- A device can run extra adapters beside the adapter of its device type, for
what that adapter does not have, like a CLI adapter for an RPC that the
device lacks over NETCONF. An extra adapter is a device type too, listed in
the device's
extra-adapterlist with an optionaladdress,portandcredentials. Without aportit uses its own default port, not the port of the address. A module goes to the first connected adapter that has it, the adapter of the device type first, and moves when an adapter connects or loses its connection. Gets, subscriptions, RPCs and event notification subscriptions go to the adapters of the modules that their top-level nodes name, and configuration goes only to the adapter of the device type.state/adaptershows whether each adapter is connected. An adapter runs as an extra adapter when it passes its device type to theDeviceMgr'son_connect()andon_disconnect(), as the NETCONF, SNMP and IOS XE CLI adapters do. See the device management reference. #756 #765 DeviceMgr.get_connected_modules()gives the modules of a device's connected adapters, andget_unconnected_durations()how long each adapter that is not connected has been without a connection. #799- Fixed devices without yang-library or netconf-monitoring, like Junos 10.4,
getting an empty module set, so transforms computed nothing for them.
Their module set has the other capabilities of their
<hello>, named by URI, except the NETCONF protocol ones. The Junos platform probe applies on thehttp://xml.juniper.net/netconf/junos/1.0capability. #721 - The NETCONF adapter fails a get whose filter names a node that the device
schema lacks, with
Filter node <path> not found in device schema. Before, those nodes were dropped from the reply without an error. #712 ncurltakes the repeatable--ssh-key-exchange,--ssh-host-key-algorithm,--ssh-cipherand--ssh-macoptions for devices that only offer old SSH algorithms, like Junos 10.4. Its newplatformcommand prints the platform the probes read. The default port is 830 instead of 42830, and without--passwordit prompts for the password instead of usingadmin. #717- After refused credentials, an untrusted host key or no common SSH algorithm, the NETCONF adapter tries to connect again once a minute instead of every second. Repeated failed logins can lock the account on some devices. A change to the device's settings connects at once. #720
- Fixed NETCONF RPCs to Junos 10.4 waiting until their timeout. Its replies
carry
xmlnstwice, which is not valid XML. The NETCONF client drops the repeated attribute with the newduplicate-attributesfixup. #719 - Fixed "Invalid NETCONF chunk framing" errors around NETCONF session restarts, seen with large mock fleets. After such an error the device adapter restarts the session once, not once for every write. #691
- Fixed the mock NETCONF server keeping a session's yang-push subscriptions after the session ended. Every client restart added another set of updates. #692
- Fixed a transform's subscriptions to a device being lost when they were
declared before the
DeviceMgrhad its adapter, for example when the device and the transform's input are written in one transaction. TheDeviceMgrpasses them on to the adapter it gets later. In Fleet Manager, a campaign could keep upgraded devices pending because the top never subscribed to their flotilla. #747 - The NETCONF adapter logs in with the first private key in the device's
credentials/key, with or without a password, on the main session and on the RFC 5277 notification sessions. Before, it connected only with a password.ncurltakes a private key file with--key. #776 - An extra adapter can have SSH settings of its own in
extra-adapter/ssh, which replace the device'ssshfor that adapter, ascredentialsdoes. The IOS SSH server of a C1111 sends no server-sig-algs, so an RSA key needspublic-key-algorithmssh-rsaon its CLI port, while its NETCONF port takes the RSA SHA-2 signatures. #776 - The
verifyRPC of the IOS XE CLI adapter runs the IOS XEverifycommand in its forms. Without an algorithm, the device checks the hashes and the signature that an image holds. Withmd5orsha512, it computes the digest, and with ahashtoo, it compares them andverifiedsays whether they match. #755 - The IOS XE CLI adapter runs install commands with its
installRPC: add, activate with an abort timer, commit, abort, remove and rollback. It says whether the device reloads. A device in bundle mode refusesinstall addalone, andinstall add file F activate commitconverts it to install mode. #777 - The
configureRPC of the IOS XE CLI adapter types configuration lines inconfigure terminalover an SSH shell, one at a time, and stops at the first line that the device rejects.write-memorysaves the configuration. Install mode bootsbootflash:packages.conf, which the boot statement has to name, and a conversion sets it this way. #777 - In mock mode, the IOS XE CLI adapter answers from a
CliMock, which a test gets withget_mock()and gives the replies of the device. #777 - The IOS XE CLI adapter logs in once per device and keeps an SSH shell open, in which it types one command at a time. IOS XE closes the connection when an exec channel ends. The device is connected while the shell is ready. When a login fails, the connection closes, or a command gets no prompt within its time, the adapter reports the device as disconnected and logs in again. After a minute without a command, it types an empty line, so a dead connection shows. #765
- The
installRPC of the IOS XE CLI adapter answers the question thatinstall removeasks before it deletes files, which has noprompt-level noneon IOS XE 17.15 and comes twice on 16.8, and the question ofinstall abort. At debug level the adapter logs each command that it types and each question that it answers. #780 - The
ios-xe-cliplatform probe readsshow versionthrough the IOS XE CLI adapter, after the NETCONF probe, so an IOS XE device without NETCONF, like 16.8 on a C1111, has a platform. Probes run over the modules of the connected adapters, so a device whose NETCONF went down reads its platform over the CLI. #799 - The IOS XE CLI adapter has a
copyRPC, which fetches a file onto the device and tells how far it is from the!marks of the copy, and adeleteRPC. It reads when the running and the startup configuration last changed, and the index of each file indir. #799 - The IOS XE CLI adapter reads the BGP neighbors into
Cisco-IOS-XE-bgp-operfromshow bgp ... neighbors, in the shape that NETCONF gives them, and realizes subscriptions by polling, as the SNMP adapter does. The fleetmgr BGP upgrade checks then work on a device without NETCONF. The polling moved out of the SNMP adapter into theadapters.polling.Polleractor, which both adapters use. #799 - Fixed event notifications of the IOS XE
-events-opermodules, likeinterface-admin-state-changeinCisco-IOS-XE-ios-events-oper, never arriving. The NETCONF adapter subscribed to them on the RFC 5277NETCONFstream, which the device accepts but sends nothing on. It now subscribes to them onyang-notif-native, as it does for the-eventsmodules. #782 - The device setting
telemetryselects how the adapter receives the data of subscriptions:push(YANG-push) orpoll. Withpoll, the NETCONF adapter reads with periodic<get>and receives event notifications through RFC 5277. Without the setting, ArcOS devices are polled: ArcOS refuses every other RPC on a session that holds a subscription. - Runtime schema fetch no longer skips
tailf-rollback. It was on the list of broken modules because acton-yang failed to compile it, andtailf-netconf-with-rollback-idimports it, so a device that lists both, like ArcOS 8.2.1A, got no schema at all. #837 - The device platform has
last-boot: when the device last booted, in seconds since the Unix epoch by the device's clock. The IOS XE probe reads it fromboot-timeand the SR Linux probe fromlast-booted; the other probes leave it out. The IOS XE mock boots when it starts and at each reload of an upgrade. [#841] - Fixed a NETCONF resync or checked edit that never finished when the device configuration does not match the schema, like a value outside a range. The resync now fails with the decode error. A checked edit fails with it before it edits the device. When only the configuration after the commit does not decode, the edit succeeds and the next checked edit resyncs first.
- A
DeviceMgrreads the running configuration of its device, and subscribes tonetconf-config-change, only from the first configuration for the device, the firstget_config()orresync(), or from the first connect withtrack_config=True. Before, it read it on every connect, so tools that only read data or subscribe, likencurl monitor, read the whole configuration too. ncurl cliis an interactive command line in the style of the Junos CLI. Its commands, completion with TAB and space, and?help come from the device schema, shaped by the Junoscli-featureand the Tail-fcli-drop-node-nameandcli-no-keywordstatements in it.show configurationprints the running configuration in curly braces, or in other formats with| display set,| display xmland| display json.configurestarts configuration mode on a candidate kept in the CLI, withset,delete,edit,up,top,rollback,run,showandshow | compare. With a command as arguments, it runs that command and exits. Without a terminal, it reads commands line by line from stdin.
Software Images & Upgrades¶
- Software images can be uploaded over HTTP into an image folder, set with
--software.image-dir. Upload withPUT /image-file/<name>, list withGET /image-fileand remove withDELETE /image-file/<name>. The newstratoweave-imagesmodule adds an image list,/images/image. Addswyang.imagesto the top layer to use it. The list and the folder are not kept in sync yet. #703 - An image in
/images/imagehas afamily, likec8000v-universalk9, and adefaultflag. A family has at most one default image./images/url-basesays where devices fetch the images from. #742 - The device software state has two new leaves:
stage, the step the run is in or ended in, andreason, set when a run fails or rolls back. The IOS XE adapter takesreasonfrom thetxn-sub-stateof the failed install. #669 - The IOS XE mock can serve a BGP neighbor for the upgrade checks. Two new
mock failures use it: with
bgp-downthe pre-check refuses the install, and withbgp-lostthe post-check fails and the device rolls back. #667 #678 - The IOS XE mock serves seven interfaces in
Cisco-IOS-XE-interfaces-operand two full OSPF neighbors inCisco-IOS-XE-ospf-operfor the upgrade checks. Two new mock failures change them while the activated release runs, until a commit or an abort:interface-losttakes the line protocol of GigabitEthernet0/0/1 and Virtual-Access2 down, andospf-lostkeeps the OSPF neighbor 10.255.0.3 in init. #821 - Removed
running-releasefrom the device software state. The release a device runs is instate/platform/version, which is read again when a software install ends, also after a rollback. #718 - Mock devices set the platform that the IOS XE mock reports under
mock/platform:version, the release before an upgrade,modelandserial-number. Without them a mock runs 17.18.02 on a C8000V.mock/platform/versionreplacesmock/software/running-release. The mock reports a release the way a device does, 17.18.02 as 17.18.2. #718 - Mock upgrades vary in length. Each takes a time within
mock/software/upgrade-duration-variancepercent ofupgrade-duration, either way, 20 by default, so devices released together no longer all finish together. 0 keeps every upgrade at exactlyupgrade-duration. #770 - A software veto holds only the install. The software manager still reads
the release the device runs and reports
up-to-date, or the newupgrade-neededwhen it differs. The vetoes are read again right before the install, so a veto added during the pre-checks holds it too. Before, a veto stopped even the read. #775 - The software state says which campaign and target release its status
answers, in
state/upgrade-campaignandstate/target-release. A final status stands, so a reconnect or an unrelated config change no longer runs a failed upgrade again. The install installs the release the run read the device for, and a target changed during the pre-checks is read again before anything is installed. #775 - Under a veto, a read of the release that fails gives
unknownwith the error, and is read again when the device connects, or after a while. Withruntime-schema-fetch, a NETCONF get or RPC on a device that has not connected yet fails as not connected, instead of with a missing schema. #775 - With
allow-staging, the software manager prepares the target while a veto holds the install: it copies the image to the device ahead of the window, once per intent. The result is instate/job[prepare], which also says whichreleaseit is for. A failed prepare leaves the statusupgrade-needed. The prepare of a run reports in the same entry. Before,allow-stagingwas stored and not used. #775 - An image in
/images/imagecan have themd5,sha256andsha512digests that its vendor publishes in itschecksumlist, and itssizein bytes. A campaign copies them with the image URL into the software intent of each device, assoftware/image-checksumandsoftware/image-size, for the device's adapter to check the staged image against. #778 - The IOS XE software adapter picks how each step of an upgrade runs from the
modules of the device's connected adapters: over NETCONF where the device
has the module for the step, else over the IOS XE CLI adapter. That covers
reading the release and the versions, the transfer, the check, add,
activate, commit and abort. It lists
bootflash:over NETCONF (Cisco-IOS-XE-platform-software-oper) or the CLI, and checks a staged image with the CLI adapter'sverify: against the image checksum of the intent, sha512 before md5, or else against the signature that the image holds. A device that can compute no checksum compares the size of the staged file withsoftware/image-size. #781 - IOS XE prepare and install can run again at any time and do only what is left. A release that the device has added needs no image file, and a staged file that passes its check stays. A missing or failing file is transferred and checked again. Install activates a release that the device has added, and a release that the device runs activated and not committed is committed instead of reported up to date. When install add refuses an image as bad, the adapter deletes the file over NETCONF, so the next run transfers it again. #781
- Before it stages an image, the IOS XE adapter waits until each adapter of the device that is not connected, such as a CLI adapter that connects after NETCONF, has been without a connection for 2 minutes. The wait counts from when the adapter lost its connection or was set up, so the later stages of an upgrade do not wait again. #781
- The IOS XE software adapter converts a device in bundle mode, which it
also detects over NETCONF, to install mode, and on IOS XE 16 it installs
with one command,
install add file ... activate commit. A C1111 went from 16.8.1 in bundle mode to 17.15.06 over the CLI alone. #799 - Before a transfer the IOS XE adapter looks for room for 2.2 times the
image size, and before an add for 1.2 times. When short, it removes the
software that the device does not run, once. The manager calls
cleanupafter the commit. A transfer that failed for lack of room says so. #799 - The IOS XE adapter removes another added release before it stages the target, and aborts another release pending commit before an install. It refuses to install while a change that someone made to the running configuration is not saved, and saves a change that the device made itself as it booted. #799
- The IOS XE commit window comes from the device's abort timer. #799
- A staged IOS XE image that passed a check is not checked again while its
index, size and modification time in
dirstay the same. #799 - The prepare job tells how far a transfer is, in
progressand in its message: over NETCONF from the size of the file on bootflash, over the CLI from the output of the copy. A software adapter reports it with the newSoftwareManager.report_transfer. An xcopy also ends when the file has the image size, as IOS XE 17.9.5a records no xcopy. #799 - No upgrade runs while the device is not connected: the software manager waits as under a veto and reads the release again when an adapter connects. #799
- The install is a job in the device software state,
job[install]. While the prepare or the install runs, the message of its job says what the device does, as the adapter reports it with the newSoftwareManager.report_step. After the install, the install job says when the commit window ends, until the run commits or rolls back. The IOS XE adapter reports the transaction that the device runs, likeadd: extractoractivate: reload, the step lines of an install command over the CLI, the check and the transfer of the image, andwaiting for the device to boot. The IOS XE CLI adapter hasinstall-progress, the last step line of the install command that runs. The IOS XE mock lists a running operation inCisco-IOS-XE-install-operand takes it through its stages. #803 - The software intent has an
attempt, 0 by default. The state has an entry for each attempt at the target in the campaign,state/attempt[number], with its status, stage, reason, checks and jobs; the entries of earlier attempts stay. A final status stands for its attempt: a reconnect, a new device type, or the target removed and set again runs nothing. A new attempt reads the device again, and runs a failed upgrade again when no veto holds the install. A run of another attempt that is under way finishes first. When that run fails its rollback, the device may run the release it installed, uncommitted, so the new attempt does not start: it answers the new statusnot-started, with the failed attempt in itsreason. A run that a new target or campaign, or a removed target, stops before its install ends atupgrade-needed. #804 - Images can be kept in folders inside the image folder. An image in
/images/imagehas afileleaf, the path of its file there, such asiosxe/17.18/c8000v-universalk9.17.18.03a.SPA.bin. Without it, the file is the image's name. A device's URL isurl-basefollowed by the file. Campaigns keep naming the image, so moving its file changes only thefileleaf, and the campaigns give their members the new URL. Members that answered or finished keep their status, since the target release stays the same.GET /image-filelists the files in every folder, by path, and the folders underfolders.PUT /image-file/<path>makes the folders on the way.PUTandDELETE /image-folder/<path>make a folder and remove one with everything in it, andPOST /image-movewith{"from": ..., "to": ...}moves or renames a file or folder without replacing anything. #806 - The software state shows the vetoes of the configuration under
state/veto, with their reasons. #811
Fleet Manager¶
- Campaigns show each device's pre-check and post-check verdicts, upgrade
stage and failure reason, and the web UI draws each run as a chain of
steps. How long the checks wait is set per device under
upgrade-checks. #667 #678 - Fixed replanning a campaign moving done and in-flight devices to the time of the replan. Released devices keep their real times, and only the waiting ones are placed again. A window that is already open is planned with the time it has left, instead of counting the devices that don't fit as late. #672
- Campaigns are paced by how many devices upgrade at the same time, with
target-concurrencyandmax-concurrency, instead oftarget-rateandmax-ratein devices per hour. With rates, slower upgrades put more devices in flight, which overloaded the system further. #723 - Fixed campaigns that never ended after a window of a schedule opened again while its earlier window still held released devices. The waiting devices were placed in both windows and counted twice. #722
- The release decisions of a campaign moved from the campaign actor into the
stratoweave.fleet_ctl.Controllerclass. The controller has no clock and no I/O, sotest_fleet_ctlruns it without an actor. #725 - Removed the
stratoweave.fleet_schedmodule. Its helpers moved intostratoweave.fleet_ctl, and the campaign simulatorstratoweave.fleet_sched_simis nowstratoweave.fleet_ctl_sim. #740 - A campaign's plan comes from the controller that releases the devices, run
ahead at the expected upgrade durations. Before, a campaign could plan
without alarms and raise alarms as soon as it ran, especially in fleets
that mix fast and slow devices. Each device keeps the window its plan
gives it, and a device that misses its window moves to the next window of
its schedule. The controller goes above
target-concurrency, up tomax-concurrency, only when the windows or the deadline need it.max-concurrencycounts the devices of the whole campaign. Plan alarms name the affected devices. A window that opened on an earlier day and is still open is used too. #730 - Devices can be members of redundancy groups, set under
/fleet/device/redundancy-groupwith aredundancy-priority. A campaign upgrades the members of a group one at a time, lower priority first and equal priorities by name./redundancy-groupssets how far apart they go:spread, the default, moves later members to later windows of the campaign where a device of the same estimate in no group can trade windows with them, andpackstarts each member as soon as the one before it is done; both keep an optionalmin-separation. When the upgrade of a member fails or rolls back, the other members keep their windows and wait as the group'sfailure-policysays. The plan's alarms name the devices that wait. #740 - Fixed upgrade duration estimates being reduced by devices that already run the target release. These devices could cause the campaign to underestimate upgrade times and schedule too many devices in the first windows. #740
- A campaign no longer raises its concurrency for good when a device
reports a few seconds late or upgrade times scatter around the estimate.
The expected pace is the mean of the last upgrades, a round and a
quarter at
target-concurrency, and a device is late only a fifth of its upgrade after it was expected to end. Before, one late device could raise the concurrency for the rest of the campaign and give alarms. #746 - A window starts a device only while its close margin is left before the
window closes, by default one and a half times the device's slow time.
The slow time is the 98th percentile of the last upgrade times, two
rounds at
max-concurrencyand at least 50, so the margin grows when slow upgrades show, and one slow upgrade alone moves it only through the mean of the last upgrades. Set the margin withclose-marginon the campaign. Before, a fifth of the expected duration was the only margin, and upgrades in a heavy tail ran past the close. A device whose margin is longer than the time left in every window of its schedule does not start, and the plan says so. #746 - The ramp lets three more devices start for each device that is done without a failure, up to the concurrency, instead of doubling once a whole round has finished. A round now takes four times as many devices, the starts spread out as devices finish, and when the plan raises the concurrency, the extra devices start as devices finish instead of all at once. Failed upgrades no longer grow the ramp. #746
- A campaign spreads its starts over the
stagger, in percent of the expected upgrade time: 25 by default. A device that starts holds the next start back by that part of its upgrade time, divided by the concurrency, so a larger campaign starts faster. Before, a window that opened with room for many devices started them all in the same second. #748 - Campaign plans are computed faster. The first plan for 100,000 devices takes seconds instead of minutes, and a decision that only starts devices reuses the last plan while no report came in, no device is due and no window opens or closes. #748
- Campaign decisions are about 6 times faster at 100,000 devices: a plan after a report takes 85 ms instead of 521 ms in a release build. Most of the gain is in the run ahead that computes a plan. The controller numbers the devices and keeps their state in lists by number, so a run ahead copies and indexes lists instead of hashing device names in tables of 100,000 entries. Each step of the controller takes the reports that it has not counted yet from a heap ordered by time, instead of going through all of them. The windows of a schedule share one count of their waiting devices and one sort of the devices by estimate, instead of one per window. The campaign reads its members' schedules, estimates and redundancy groups from the inventory when the campaign or the inventory changes, instead of at every decision. #787
- Fixed a member whose final report came before its release, but in the same second, counting as an upgrade of one second. It happened to members that were already up to date when the campaign started, and dragged the campaign's pace down. #766
- Maintenance windows that are open at the same time share a campaign's free slots. Before, the window that opened first took every slot it could use, and a window that opened later waited until the first had nothing left to start. Each schedule with an open window now gets slots by the upgrade time it must start before the first of their last starts, counting the time it has after the others close. So a schedule with time of its own at the end leaves the slots to one that closes first, and a deadline needs about the concurrency it needed before. Windows that close together share in proportion to the upgrade time waiting in them. #770
- Fixed an edit of a campaign, or of its schedules, images, redundancy groups or member devices, removing the software intent of the devices that the campaign had released, until the campaign wrote it again a moment later. An upgrade that had not reached its install could fail. #783
- Campaigns acquire their members in
planand inrun. Each member in the fleet gets the campaign's name, its target release and image URL, and a veto with the holdercampaign:NAME, which holds the install. So each member reads the release it runs and answersup-to-dateorupgrade-needed, and nothing is installed. A member added to a running campaign is acquired the same way. Inrun, the campaign removes a member's veto when it releases the member, and puts it back when the member is done. Before, a campaign wrote nothing until it released a member in a window. #783 - A device in the fleet is in one campaign at most, also while the
campaign is in
planand after it is done. An edit that names a device in a second campaign fails with "Cannot merge leaves with different values at /software/upgrade-campaign". To move a device, remove it from its campaign, or delete the campaign, in an earlier edit. A device that is not in the fleet gets nothing from a campaign, so two campaigns can name it. The edit that adds it to the fleet then fails with the same error until only one campaign names it. #783 - A campaign's
device-statusshows a member's status only when the status is for the campaign's intent, its name and the member's target release, andpendingotherwise. The counters count only those statuses. Before, asucceededleft from an earlier campaign made a member done at its release, with no upgrade. #783 - Setting a running campaign back to
planpauses it: members in flight stop before their install, and are released again when the campaign runs again. A member that still reportsin-progressfor the campaign when it runs again, or after a restart of fleetmgr, counts in flight and keeps the campaign's veto until it is done, or until it stops before its install. Stopping a campaign and running it again no longer retries its failed members. #783 - With
allow-staging, a campaign inrunlets each member that needs the upgrade, and that the plan gives a window, prepare its image once before its window, under the campaign's veto. The first member prepares at once. The others follow as far apart as their deadlines allow: the opening of the next window of the member's schedule, lessclose-marginpercent of its expected prepare time. No member prepares while a window of its schedule is open, and a failed prepare is not tried again. Inplannothing is copied. The plan's newprepare-startsays when each member prepares, andprepare-concurrencyhow many copies run at most at once; there is no cap.device-statusshows each member'sprepare, and the new counterspreparingandpreparedcount the members that wait for their release. New plan alarms: "N device(s) cannot prepare before their window opens" and "N device(s) failed to prepare and copy the image in their window". The upgrade in the window still copies the image again. Before,allow-stagingon a campaign had no effect. #784 - A campaign releases a member only once the member's status answers the
campaign's target:
upgrade-needed, or a final status. Until then the plan holds the member in its window, with the alarm "N device(s) have not answered the campaign's target", and the members after it in its redundancy groups with "N device(s) wait behind a redundancy group member that has not answered".unknownandpendingare no answer. A campaign inplanplans again as its members answer, and plans a run that starts now, so its plan shows whatrunwould do. So a member added to a running campaign waits until it has read the release it runs, and is then planned and released. A campaign created directly inrunpromises its windows in the order its members answer. Create it inplanfirst to keep the campaign's order. A decision that only starts devices still takes the last plan again when the plan's only alarms are for held devices. #783 - A campaign's new
failure-budget, in percent of its members, stops its releases when more members have failed than the budget. The members in flight finish, and the plan's alarm says "N device(s) failed, more than the failure budget of M: no more devices start". To go on, raise or remove the budget, or remove failed members. Without a budget, a campaign releases as before. #791 - A campaign holds a waiting member while the member is down: its flotilla
is not connected to it, or the top is not connected to its flotilla. The
member starts when it is back up, so a dead flotilla holds only its own
members. Before, a member that was down was released and failed. Each
held member's
device-statusgives the reason inheldand the device or flotilla that holds it inheld-by, andstate/heldcounts them. New plan alarms name the members that are down, the members in flight that are still down after their expected end, and the held members that lost the window promised to them. #794 - A campaign's new
notification-period, in days, gives the customers of its members time to be told about their window: the campaign uses only the windows that open that long or more after it first went torun. That time is the campaign'sstate/run-since, and a pause and a restart of fleetmgr keep it. For a campaign from an earlier version,run-sinceis the time Fleet Manager first starts on this version, or, for a campaign inplan, the time it next goes torun. 0, the default, gives no notice. #795 - A campaign member has an
attempt. Changing it tries the member again: the campaign takes it as a new member, its device reads its release again, and a member that failed is released again in a window. A member in flight gets the campaign's veto back; a run past its install finishes and holds its slot until it ends. Removing a member and adding it again no longer tries it again: its device keeps the final status of its attempt.device-statusshows the attempt that counts, the one in progress or else the member's attempt, in its newattempt, and no longer theupgrade-campaignandtarget-releaseof the device. A member with a new attempt no longer counts against the failure budget. A new attempt set while a run fails its rollback does not start: the member showsnot-started, counts as failed, and holds its redundancy groups as a failed rollback does, until it has another attempt. #804 #814 - A redundancy group's new
failure-policysays what a failed member does to the other members. Withcontinue, the default, a member that failed or rolled back holds them only until it is done and up again, and the next member starts after the group'smin-separation. A member whose rollback failed is in an unknown state, and holds them until an operator acts. Withhold, the other members wait for an operator after any failure, as before. #811 - A campaign holds a member whose device has a veto of another holder,
such as a service health check, until the veto goes.
device-statusshows the device's vetoes, and the held reasonvetoedwith the veto's holder inheld-by; the members after it in its redundancy groups are held asgroup-vetoed. The plan's alarm says "N device(s) are held by a veto of another holder". A released member that gets such a veto before its run starts, or that the veto stops before its install, waits again and frees its slot. Before, the campaign released it, and it held a slot while its device did not install. #811 - Each
/fleet/devicesays instate/connectedwhether it can be reached:connected,device-downwhile its flotilla is not connected to it, orflotilla-downwhile the top is not connected to its flotilla. A device that was down before the top lost its flotilla staysdevice-down, as a campaign holds it fordown.state/connectedis absent while the device has not connected since fleetmgr started. A campaign's newstate/up-to-datecounts the members that answeredup-to-date, as they already ran the target release when they read it;succeededstill counts them too. #816 - A campaign member whose status is final while it waits is done at once,
without a release: a member that is up to date, or one that succeeded or
failed before a pause. It takes no window and no slot, and adds nothing to
the pace or the ramp. The next member of its redundancy groups waits the
group's
min-separationfrom the answer of a member that is up to date, or, when that member upgraded in the run before it got a new attempt or joined again, from the end of that upgrade. After one that upgraded before a pause it waits themin-separationfrom that member's report. A failed one still counts against the failure budget and holds its groups as theirfailure-policysays. The plan shows it in no window, and the campaign page counts it as already done. It waits again when its final status goes. Before, it waited for a window of its schedule and held a slot there until the next decision. #830 - Each
/fleet/devicehas the platform that its flotilla reads from the device understate/platform, absent until the device has connected. A campaign'sdevice-statushas each member'sversionandmodelinstead ofrunning-release. The web UI shows the platform on the devices, device and campaign pages, and the devices page filters by model. #718 - The top always starts ten flotillas and places each device on
flotilla-Nby a hash of its name. Removed/fleet/nodeand/fleet/device/shard. Devices without a shard, which the top managed itself, are no longer supported. #713 - Campaigns select an
imagefor each device instead of setting onetarget-releaseandimage-urlfor the whole campaign. Images must be listed under/images/imagewith aversion. The campaign does not configure an upgrade for a device if its image is missing from the list or has no version. An alarm identifies the image and how many devices are affected. The campaigns page no longer has a Release column. #743 #759 - The new campaign page has three steps: pick devices by filtering or from pasted names, pick an image for each model in the selection, and create the campaign, which opens its page to set the schedule and pace. A family's default image is preselected when exactly one default image lists the model. Devices that haven't reported a model are left out, and a model that no image lists prevents campaign creation. #743
- The web UI has image pages. Image files dropped on them are uploaded, with
OS, version and family filled in from IOS XE file names. An image can be
made the default of its family, and the images page sets the image list's
url-base. Deleting an image also deletes its file. #709 #743 - The web UI's images page browses the image folder like a file manager:
open folders, make them, upload into the one shown, and rename, move and
delete files and folders, from a row's menu, by dragging rows onto a
folder, or on several selected rows at once. A move changes the
fileof the images it takes along and keeps their names, also for images that campaigns install. An upload whose file name is already an image's name fails before the file is sent. Search covers the folder shown and the folders in it, and files that the image list lacks show, ready to add. #806 - The web UI's image pages have a Checksum field for the checksums that the
vendor publishes: MD5, SHA-256 or SHA-512, told apart by their length. An
upload sets the image's
sizefrom the file. #823 - The web UI has a Config page that shows the top's configuration, the state its transforms publish, or both, as XML, JSON or AData. The Apply config page merges JSON or XML configuration into the running system with a RESTCONF PATCH, after a confirmation. #736
- The web UI has a search, in the header or with Ctrl/⌘+K, that jumps to a page, campaign, image, device or schedule by name. #737
- The web UI has redundancy group pages: a list, one page per group with its members in upgrade order and its separation, and a page to create a group. A member's priority can be typed there, or the member dragged to another place, which sets the priorities that give that order. A change that reorders another group of the device asks first. The device page sets a device's groups and priority, and the devices page shows and filters by group. The demo fleet pairs devices in groups. A campaign's page shows the groups of its members, each member in upgrade order with its status and time. Groups held behind a failed member come first, with a button that takes that member out of the group. #789
- The campaign page has Schedule and pace under the plan, folded each time the page opens. The failed devices, the redundancy groups and the devices fold too, and only the failed devices start open. Folded, the redundancy groups say how many of them are held. #789
- The campaign page's Revert to plan is now Pause, and its confirmation says
what a pause does: members that upgrade stop before their install and go
on when the campaign runs again. A campaign in plan that has run shows as
paused. Schedule, pace and limits set the campaign's
close-marginandstagger. #823 - The device page is redesigned around the device's upgrade run. #674
- The web UI's add and import device forms take a username and password, instead of writing admin/admin for every device. Import uses one pair for all its devices. #726
- The web UI's add and import device forms take a private key file, and a
CLI over SSH box that gives the device the
iosxe-cliextra adapter, on port 22 or the port typed. A device with an address needs a password or a key. Import gives the CLI only to the devices with an address. #823 - The web UI works on narrow screens and has better contrast and accessibility. The campaign page leads with live progress and failures. #679
- The web UI reads less from the server. Each page reads only the fields
that it shows, with the RESTCONF
fieldsquery parameter, and the device page no longer reads the device's credentials. The pages that read the whole fleet, like the devices page, share one read for 30 s, so a change that another client makes can take that long to show. #671 #689 #807 - Web UI pages show at once and fill in as their reads arrive, and the
sidebar marks the page that is loading. On large fleets the pages read
less: the device page reads only the device's own
device-statusentry, a large campaign's page reads its state less often the longer the read takes, and adding, importing, removing or scheduling devices updates the devices list without reading the whole fleet again. Newly added devices show no model or version until the page is loaded again. #754 - Fixed the campaign plan timeline drawing a crowded window past its end. Its columns grow taller instead. #761
- The campaign page shows why members wait. Its progress bar splits the
members that it upgraded from those that were up to date already, and
the members that wait into held, not answered and waiting, and says what
holds the held ones: the device or its flotilla being down, a veto of
another holder, a member of its redundancy groups, or the failure budget.
Before, up-to-date members counted as succeeded, and every waiting member
as pending or unknown. The devices table says why each held member waits,
links the group member that holds it and filters by the reason. The plan
timeline draws members that are down grey and the other held members
amber, with a legend of the colours it shows, and leaves out the members
that already run their target, which are listed above it. The redundancy
groups take whom each member waits behind from the campaign, and offer to
take out only the failed members that others wait behind. A
pendingmember shows as not answered, and the device page names the attempt it has not answered. #816 - The campaign page sets the campaign's notification period and failure budget, shows how many failures the budget allows and how many there are, and when the campaign first ran. #816
- The new campaign page shows, for each model, how many of the selected devices already run the picked image and how many run a newer release. It leaves out the devices that run their image, unless told not to, and warns that the campaign would downgrade the newer ones. #816
- The devices and device pages show whether each device can be reached. #816
- The redundancy group pages set a group's
failure-policynext to its separation, and the groups list shows it. On a campaign's page, each group gives its policies under its name, a member whose rollback failed says so, as it holds its groups whatever their policy, and the confirmation to take a member out says why the group waits for it. #819 - fleetmgr and flotilla run Acton's generational garbage collector. Start
them with
ACTON_GC_MODE=ordinaryfor the ordinary collector. #764 - Removed the unused
cpe-devicemodel. The IOS XE device type directory is nowdev-iosxe. #694 just demo-alldeploys the CEs, starts the top and loads both campaigns. #690just runstarts the top and its ten flotillas with no devices, images or campaigns. #736just buildbuilds fleetmgr and flotilla with--release, optimized for speed and without debug symbols. #805- The web UI is built with SvelteKit 3, and
just gen-webuineeds Node 22.17 or newer. #739 - A fleet device can have extra adapters, as a StratoWeave device can: the
extra-adapterlist with the type, address, port, credentials and SSH settings of each, which the transforms pass to the device on its flotilla. The flotillas register the device typeiosxe-cli, the IOS XE CLI adapter, so an IOS XE device can have the CLI beside NETCONF. #779 - A fleet device has
upgrade-checks/enabled, true by default. With false, its upgrades go without the pre- and post-checks. #799 - The flotilla checks a device's interfaces and OSPF neighbors before and
after an upgrade, as it checks BGP. The
interfacespost-check wants every interface that was up, line protocol up, before the upgrade to be up again, NVI and Virtual-Access interfaces aside, and as many Virtual-Access interfaces up. Theospfpost-check wants the same OSPF neighbors, each in the same state. Their pre-checks only record what they read. The checks are registered asbgp,interfacesandospfinstead ofrfs-device-health, so a verdict says what each check saw. As before, the device is read only while a check runs, andupgrade-checkssets the waits of all three or turns them off. No adapter reads the interfaces or the OSPF neighbors of an IOS XE device without NETCONF, such as 16.8 on a C1111, so its pre-checks refuse unless the checks are off. #821 - The prepare in the upgrade status of a fleet device, and in the
device-statusof a campaign, hasprogress: how far the device's transfer is. #799 - The upgrade status of a fleet device, and the
device-statusof a campaign, haveinstall: the device's install job, whose message says what the device does. The web UI shows it for each device of a campaign and on the device page, with a bar for the transfer of the prepare. #803 just demogenerates its fleet likejust demo-fleet: a hundred devices of five models, most on 17.15.04, some older and a few already on 17.18.03a, and a campaign over 80 of them whose windows open within three minutes. The other 20 are left to pick for a new campaign. The demo images are four families in three releases, each family in its own folder, with an empty sparse file for each inout/images.demo.xml,demo-campaign.xml,upgrade.xml,just upgradeandjust upgrade-and-watchare gone. #825- A
/fleet/devicehas the device'slast-bootinstate/platform. [#841] - A member that is done without a release, and whose upgrade the campaign
did not see end, is done when its device last booted, when the device
tells. After a restart of fleetmgr, the next member of its redundancy
groups then need not wait for a device that has run the target for
months, and waits the
min-separationfrom the boot of one that booted a minute ago. When the campaign saw the member's upgrade end, in the run or before a pause, the member is done at that end, or at a later boot. A member whose device does not tell is done at its answer, as before. [#842]
Dependencies¶
Acton¶
- Requires Acton newer than 0.31.0, for explicit parameter defaults
acton#3211, the
Envservices acton#2768, the write barriers of the generational garbage collector acton#3390, HTTP server bodies as bytes acton#3403, compressed HTTP responses acton#3404 and the raw terminal mode of stdin acton#3419.
acton-yang¶
- gdata is encoded as compact XML and JSON by default, as in the Acton stdlib. Pretty output was only meant for developers. acton-yang#541 #684
- Removed the YANG parser statement cache and the
yang.compile_with_cache()function. With the recent improvements to Acton RTS and GC that part of the pipeline is no longer significant.~/.cache/ayangis not used any more. acton-yang#544 DRoot.module_metadataentries areyang.schema.ModuleMetadatatuples, with the module innameinstead ofmodule. The newsubmodulesandimplementedfields are for schema discovery APIs. acton-yang#545- Optional APIs and generated constructors declare explicit defaults.
- Fixed YANG patterns with a
.or$in a character class. The nokia-conf module of SR OS 25.10 failed to compile with "Invalid range bound", and[.]and[$]matched any character and the end of the string instead of a literal dot and dollar sign. acton-yang#546 #729 - YANG sources are parsed concurrently, which makes compiling large module
sets faster. Removed
yang.parse_modules()andyang.compile_from_stmt(), which were only needed for the statement cache. acton-yang#550 yang.schema.DRoot.merge()merges compiled schema roots into one, like the CFS schema and ietf-yang-library that a northbound server serves together. It raisesValueErrorwhen two roots hold the same top-level node or different revisions of a module. acton-yang#548take_leaf()andtake_leaflist()of theyang.data.YangDataprotocol return nottype field. gdata keeps a union's value as its Acton type, so the field is no longer needed. acton-yang#553- The
take_container(),take_list(),take_leaf()andtake_leaflist()methods ofyang.data.YangDatano longer take the node's adata attribute name. The adata generator stores that name in the schema as the newadata_nameof each node, andyang.data.from_data()reads it from there instead of computing it on every call. acton-yang#552 yang.schema.DNode.gnameis the node'sgdata.Idinstead of the name of its gdata class, likeContainer, and aDListhas thegdata.Idof each key inkey_gnames.yang.data.from_data()uses them instead of creating agdata.Idfor every node it reads, and the generated adatafrom_gdata()methods usegdata.Idconstants of their module. Fleet Manager with 50,000 devices has all of them connected in 22 s instead of 33 s. acton-yang#557 #762- Fixed subscription data callbacks running in the provider's actor.
yang.gdata.Dstand the data callback ofTreeProvider.declare_subscriptionstake an action again instead of a proc, so a consumer that passes its actor method gets the data in its own actor. A generateddst()converts each tree in an actor of its own instead of in the provider. acton-yang#556 #758 - Fixed XML parser skipping a leaf with an empty tag, like
<k1/>or<k1></k1>. Its normalized value is an empty string. This makes it possible to use the empty string as a key value too. acton-yang#554 #744 - A
root_pathpassed toyang.data.from_data()can lead to a notification, top-level or nested in a container, so a notification payload decodes like RPC output. acton-yang#555 - Fixed XML decoding keeping only the first of a container element that
occurs more than once in the same parent. IOS XE 17.15 periodic yang-push
updates repeat
<neighbors>for each BGP neighbor, so a NETCONF subscription got only the first neighbor and the fleetmgr BGP post-check failed. The occurrences are now read as one container. acton-yang#560 #802 yang.restconf.resolve_fields()parses a RESTCONFfieldsvalue against the schema below the target resource, andselect_fields()narrows data to the result. acton-yang#561yang.compile_with_sources()compiles likeyang.compile()and also gives each source with the name and revision of its module or submodule, as ayang.schema.YangSource.DRoot.prschema()andDRoot.prdaclass()take theirschema_yangsources in that form, and the generatedsrc_yang()functions return them. acton-yang#562- Fixed subtree filters dropping a list entry when one of its selection nodes selected nothing. A fleet device in no campaign has no software state on its flotilla, so the top's subscription got nothing and the device showed no platform or connection. A content match node that matches is now in the output too. acton-yang#563
- Imports Acton library modules from
std, and the schema code generator writesimport std.base64andimport std.jsoninto the modules it generates. acton-yang#565 - Fixed the compile failing on an augment whose target is inside a
structure:
tailf:structure,sx:structureorrc:yang-data. A structure describes a message, not datastore data, and its contents are not compiled, so the augment is now skipped. An augment into any other extension still fails. ConfD'stailf-rollbackaugments a structure oftailf-yang-patchlike this. acton-yang#564 - Fixed relative leafref paths in an action, an rpc or a notification. The
action, rpc or notification is the parent of its leaves (RFC 7950 6.4.1),
but the path left it out, so
..went one level too far, and in an rpc../aresolved to a top-level leafa. A path into another action or rpc than the one that holds the leafref now fails. acton-yang#564 - A leafref path can have whitespace between two predicates, like
acl-set[name=current()/../name] [type=current()/../type], as XPath and ConfD allow. The path used to end at the whitespace, so it pointed at the wrong node. A path with any other trailing input now fails to compile. acton-yang#564 - A JSON leaf with the value
nullfails to decode, as RFC 7951 requires. acton-yang#566
acton-ssh¶
- Fixed SSH events being delivered out of the order libssh raises them. Under load, pipe streams were reordered and broke NETCONF chunk framing. acton-ssh#15
- Fixed a
Clienthanging forever when itson_hostkeyhandler never responds.connect_timeoutalso covers theon_hostkeydecision. acton-ssh#6 SshPipetakesconnect_timeoutandauth_timeout. Before, it always used theClientdefaults of 10 seconds. acton-ssh#18SshPipecan request an interactive shell withshell=True, instead of a subsystem or a command. acton-ssh#20- Builds with Zig 0.17. acton-ssh#17
- Imports Acton library modules from
std. #833 - Connect failures are reported as
ssh.SshError, or its subclassesKeyExchangeError,HostKeyErrorandAuthenticationError, instead of anOSErrorfor everything. AnOSErroris left for failures before the server's SSH banner, like a refused TCP connect.Client.on_connectgets an exception instead of a string. acton-ssh#21 - Stores GC pointers with write barriers, so programs that link it can run in Acton's generational GC mode. acton-ssh#23
ssh.Serverserves interactive shells when it gets anon_shellaction, which receives the client's terminal as aPtyRequest, orNonewhen the client asked for none. Withouton_shellthe server refuses shells, as before.Channel.change_pty_size()sends a terminal size change, which aServerChannelreceives withon_window_change. acton-ssh#24- Fixed writes that queue more than 8 MiB failing their channel, which kept
a NETCONF message over 8 MiB from going out over an
SshPipe.max_write_bufferofClientandServerdefaults to 0, no limit. Writes go to libssh in pieces of at most 256 KiB, which also bounds libssh's send buffer per connection. acton-ssh#25 ssh.ScpPutandssh.ScpGetcopy one file to or from the server over SCP on an existingClient, without blocking. They run the server'sscpon an exec channel and hold the whole file in memory. acton-ssh#22- Fixed a busy loop while a channel has writes queued and the peer's window is shut. acton-ssh#22
- A failed connect or a dropped connection reports the socket's error, such as "connection refused" or "no route to host", instead of "bad file descriptor". acton-ssh#22
acton-lmdb¶
- Builds with Zig 0.17. acton-lmdb#6
actmf¶
- Updated for explicit defaults, for Acton library modules imported from
std, and for the changes to theyang.data.YangDataprotocol andyang.schema.DNode.gnamein acton-yang. actmf#76 actmf#78 actmf#79 #741 #790
actsnmp¶
- New dependency: an SNMP implementation in Acton, with SNMPv1, v2c and v3 and a MIB compiler that emits YANG (RFC 6643). The SNMP device adapters use it. #701
http-router¶
- Query parameter names and values are percent-decoded.
Context.query()gives every value of each name as a list, in request order, instead of one value, andquery_param()gives the first. #805 - Imports Acton library modules from
std. #833 - The
respondcallback of handlers and middleware takes the body asbytesinstead ofstr, ashttp.Serverin Acton does. acton#3403
Documentation¶
- The software upgrade reference is rewritten to match the code, and is part of the guide. #697
- The guide has a Releases page, which includes this changelog, and a Roadmap page. #800
Testing & CI¶
- Downstream upgrade PRs run
make gen, so changes to generated code don't break the downstream's checks. #706 - Removed the actor pipe restart stress test, which was too slow for CI. #696
- Fixed the build of the multi-arch
ghcr.io/stratoweave/ncurl:latestimage on runners with Docker Engine 29. #735 - The notconf tests connect to 127.0.0.1 instead of
localhost, which macOS resolves to IPv6 first, where Docker's published port does not answer. #751 - Fixed
just system-testin fleetmgr timing out. It runs each system test once. #747 - The
gc-checkCI job runs the fleetmgr tests withacton test --gc-checkand the fleetmgr demo for a minute under the GC write-barrier checker. #764
Compatibility Notes¶
- Requires Acton newer than 0.31.0. Regenerate generated code with
make genafter upgrading. #704 #764 adapter_typeandsoftware_adapter_typein aDeviceTypetake?Envinstead of?net.TCPConnectCap. Adapters in other repositories, like sw-adapter-cisco-ios-cli, need the same change. #702- gdata
to_xmlstr()andto_yang_jsonstr()return compact output by default. Passpretty=Truefor indented output. acton-yang#541 /restconf-state/capabilitiesno longer lists YANG modules. Read them from/ietf-yang-library:modules-stateor/ietf-yang-library:yang-libraryinstead. #676- The NETCONF server's
<hello>lists no module capabilities, onlyyang-library:1.1. Clients that take the server's modules from the<hello>must read them from/yang-libraryor/modules-state. #716 - The device software state has no
running-release. Read the release a device runs fromstate/platform/version, and in Fleet Manager from theversionof a campaign'sdevice-status. Mock devices take the release they start on asmock/platform/versioninstead ofmock/software/running-release. #718 - An app with its own
device_types.actmust addimport stratoweave.platform_probes as swplatandplatform_probes: list[swdev.PlatformProbe] = swplat.PROBESto it. The generatedsysspec.actreadsplatform_probesfrom it, and the generator does not change an existingdevice_types.act. #712 - Fleet Manager has no
/fleet/nodeand/fleet/device/shard. Remove them from its configuration. #713 - Fleet Manager campaigns take
target-concurrencyandmax-concurrencyinstead oftarget-rateandmax-rate. Move configuration that sets the old leaves. A campaign that sets neither upgrades 10 devices at once and goes up to 50 when its windows or deadline need it. There is no unlimited value. #723 - Fleet Manager campaigns take an
imagein eachdeviceentry instead oftarget-releaseandimage-url. Add the images to/images/image, with theirversion, set/images/url-base, and name an image for each member. #743 - A device can be in one Fleet Manager campaign only. Before you upgrade, remove each device that two campaigns name from one of them. Otherwise Fleet Manager cannot load its configuration and does not start. #783
- Since a NETCONF
<edit-config>transaction completes before the devices have applied their configuration, a device rejecting its configuration is no longer reported as anrpc-error. The device side is visible per device instead:state/adaptershows whether it is connected, and the inspection API's/device/<name>/infoand/device/<name>/logshow its queue and what was sent to it. #792 DeviceMgr.get_config()takes adoneaction and gives the running configuration that theDeviceMgrkeeps, or reads it from the device. It returned the adapter's copy before.get_running_conf()givesNoneuntil the first read.stratoweave.main()takesstatic_assetsasdict[str, bytes]. Have the web UI build embed each file as abytesliteral, as fleetmgr'sgen-embedded-assets.mjsdoes. http-router handlers and middleware callrespondwith abytesbody: call.encode()on astrbody.
26.10 - 2026-10-23¶
Hello, world! This is the first formal release of StratoWeave, woven from first principles.
There’s still work ahead before it’s ready for production, but it’s coming together quickly, and we think it’s ready for people to pick up and try. This release is an invitation to explore, experiment, and help shape what comes next. Give it a spin. We’d love to hear what you think.