9fa5e216c4
w-level general upgrades and as a complement to module-specific upgrade. * Called on startup after initial XML parsing, but before module-specific upgrades * Enabled by definign the `.ca_datastore_upgrade` * [General-purpose upgrade documentation](https://clixon-docs.readthedocs.io/en/latest/backend.html#ge neral-purpose) * JSON parse error messages change from ` on line x: syntax error,..` to `json_parse: line x: syntax err or` * Unknown-element error message is more descriptive, eg from `namespace is: urn:example:clixon` to: `Fai led to find YANG spec of XML node: x with parent: xp in namespace urn:example:clixon`. * C-API parse and validation API more capable * `xml_spec_populate` family of functions extended with three-value return values * -1: error, 0: parse OK, 1: parse and YANG binding OK. * `xml_parse` and `json_parse` API changes * Three value returns: -1: error, 0: parse OK, 1: parse and YANG binding OK. * Extended `xml_parse_file2` and `xml_parse_string2` extended API functions with all options available. * New concept called `yang_bind` that defines how XML symbols are bound to YANG after parsing * Existing API same except `xml_parse_file` `endtag` argument moved to `xml_parse_file2` * C-API: Added instrumentation: `xml_size` and `xml_stats_get`. * Fixed: Enabling modstate (CLICON_XMLDB_MODSTATE), changing a revision on a yang, and restarting made the backend daemon exit at start (thanks Matt) * Also: ensure to load `ietf-yang-library.yang ` if CLICON_XMLDB_MODSTATE is set
135 lines
3.3 KiB
Bash
Executable file
135 lines
3.3 KiB
Bash
Executable file
#!/usr/bin/env bash
|
|
# Test of the general-purpose (raw) upgrade mechanism.
|
|
# Input is a startup db without mod-state info.
|
|
# It has wrong namespace bindings and needs to remove some nodes
|
|
# Output is a valid config woith correct namespaces and removed nods
|
|
# The code for this is in the main example backend plugin.
|
|
|
|
# Magic line must be first in script (see README.md)
|
|
s="$_" ; . ./lib.sh || if [ "$s" = $0 ]; then exit 0; else return 0; fi
|
|
|
|
APPNAME=example
|
|
|
|
cfg=$dir/conf_yang.xml
|
|
fyangA=$dir/A.yang
|
|
fyangB=$dir/B.yang
|
|
|
|
# Create configuration
|
|
cat <<EOF > $cfg
|
|
<clixon-config xmlns="http://clicon.org/config">
|
|
<CLICON_CONFIGFILE>$cfg</CLICON_CONFIGFILE>
|
|
<CLICON_FEATURE>ietf-netconf:startup</CLICON_FEATURE>
|
|
<CLICON_YANG_DIR>/usr/local/share/clixon</CLICON_YANG_DIR>
|
|
<CLICON_YANG_MAIN_DIR>$dir</CLICON_YANG_MAIN_DIR>
|
|
<CLICON_SOCK>/usr/local/var/$APPNAME/$APPNAME.sock</CLICON_SOCK>
|
|
<CLICON_BACKEND_DIR>/usr/local/lib/example/backend</CLICON_BACKEND_DIR>
|
|
<CLICON_BACKEND_PIDFILE>/usr/local/var/$APPNAME/$APPNAME.pidfile</CLICON_BACKEND_PIDFILE>
|
|
<CLICON_XMLDB_DIR>$dir</CLICON_XMLDB_DIR>
|
|
<CLICON_XMLDB_MODSTATE>true</CLICON_XMLDB_MODSTATE>
|
|
<CLICON_CLISPEC_DIR>/usr/local/lib/$APPNAME/clispec</CLICON_CLISPEC_DIR>
|
|
<CLICON_CLI_DIR>/usr/local/lib/$APPNAME/cli</CLICON_CLI_DIR>
|
|
<CLICON_CLI_MODE>$APPNAME</CLICON_CLI_MODE>
|
|
</clixon-config>
|
|
EOF
|
|
|
|
# Yang module A (base)
|
|
cat <<EOF > $fyangA
|
|
module A{
|
|
prefix a;
|
|
revision 2020-02-11;
|
|
namespace "urn:example:a";
|
|
container x {
|
|
container y {
|
|
}
|
|
}
|
|
list remove_me {
|
|
key k;
|
|
leaf k {
|
|
type string;
|
|
}
|
|
}
|
|
}
|
|
EOF
|
|
|
|
# Yang module B (augments A)
|
|
cat <<EOF > $fyangB
|
|
module B{
|
|
prefix b;
|
|
revision 2020-02-11;
|
|
namespace "urn:example:b";
|
|
import A {
|
|
prefix "a";
|
|
}
|
|
augment "/a:x/ngrt:y" {
|
|
container z {
|
|
leaf w {
|
|
type string;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
EOF
|
|
|
|
# permission kludges
|
|
sudo touch $dir/startup_db
|
|
sudo chmod 666 $dir/startup_db
|
|
|
|
# This is how it should look after repair, using prefixes
|
|
AFTER=$(cat <<EOF
|
|
<x xmlns="urn:example:a"><y><b:z xmlns:b="urn:example:b"><b:w>foo</b:w></b:z></y></x>
|
|
EOF
|
|
)
|
|
|
|
testrun(){
|
|
new "test params: -f $cfg -- -U"
|
|
# Bring your own backend
|
|
if [ $BE -ne 0 ]; then
|
|
# kill old backend (if any)
|
|
new "kill old backend"
|
|
sudo clixon_backend -zf $cfg
|
|
if [ $? -ne 0 ]; then
|
|
err
|
|
fi
|
|
new "start backend -s startup -f $cfg -- -U"
|
|
start_backend -s startup -f $cfg -- -U
|
|
|
|
new "waiting"
|
|
wait_backend
|
|
fi
|
|
|
|
new "netconf get config"
|
|
expecteof "$clixon_netconf -qf $cfg" 0 "<rpc><get-config><source><candidate/></source></get-config></rpc>]]>]]>" "^<rpc-reply><data>$AFTER</data></rpc-reply>]]>]]>$"
|
|
|
|
if [ $BE -ne 0 ]; then
|
|
new "Kill backend"
|
|
# Check if premature kill
|
|
pid=$(pgrep -u root -f clixon_backend)
|
|
if [ -z "$pid" ]; then
|
|
err "backend already dead"
|
|
fi
|
|
# kill backend
|
|
stop_backend -f $cfg
|
|
fi
|
|
|
|
} # end testrun
|
|
|
|
# Create startup db of "old" db with incorrect augment namespace tagging
|
|
# without modstate
|
|
cat <<EOF > $dir/startup_db
|
|
<config>
|
|
<x xmlns="urn:example:a">
|
|
<y>
|
|
<z>
|
|
<w>foo</w>
|
|
</z>
|
|
</y>
|
|
</x>
|
|
<remove_me xmlns="urn:example:a"><k>This node is obsolete</k></remove_me>
|
|
<remove_me xmlns="urn:example:a"><k>this too</k></remove_me>
|
|
</config>
|
|
EOF
|
|
|
|
new "general-purpose upgrade without modstate"
|
|
testrun
|
|
|
|
rm -rf $dir
|