Differences

This shows you the differences between two versions of the page.

--- guides:user:scenarios:basic_cmd_debug [2022/04/29 08:24] – pgels
+++ guides:user:scenarios:basic_cmd_debug [2024/07/03 12:31] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
+===== Basic cmd job with debug details =====
+Each scenario file defines exactly one job to be executed by the scheduled Tasker.pl
+These scenario files are created and scheduled by the YCE web front-end and are stored in the ''/var/opt/yce/jobs'' directory.
+<code>
+<node> := switch1
+<verbose> := -v
+task := Basic_cmd_job
+</code>
+==== Scenario execution ====
+Each scenario file is executed by the ''tasker2.pl'' and is normally started using the at-queue for scheduling purposes.
+The standard (log) output lists the compiled line number along with the action to be performed and its arguments.
+<code>
+$ /opt/yce/bin/tasker2.pl -l -j 0322_0002 -o 'xml'
+switch1 Command_job...
+JobID: 0322_0002
+-Description (switch1 Command_job...)
+-Description (Command_job on switch1)
+   Establishing new session 'mgmt' for 'switch1'
+   == Start for 'mgmt' to 'switch1'
+   -- Start - reachable
+-03-22 10:27:05 Unreachable 'switch1': Address(es) not reachable at ports '23 '
+   Session 'switch1' mgmt at '198.172.0.3' was aborted
+   Action 'Start - reachable' aborted: Scenario stopped
+ERROR: 'import_cfg' failed:
+      Session 'switch1 - ' not found
+-Function (Import_cfg -q -n switch1 -f switch1.cmd -v)
+-If (if <error>)
+-Function (LogAction -n switch1 -a Command_job -m "Failed executing commands")
+-Stop: job finished
+-03-22 10:27:05 ABORTED after 9 seconds
+</code>
+When a scenario is created, the Tasker evaluates and parses the script for errors. The result is shown as an indented script along with the line-numbers as shown during the execution.
+<code>
+$ /opt/yce/bin/tasker2.pl -l -j 0322_0002 -o 'xml' -t
+Parsing scenario:
+[Scenario]
+Description switch1 Command_job...
+Description Command_job on switch1
+Import_cfg -q -n switch1 -f switch1.cmd -v
+if <error>
+     LogAction -n switch1 -a Command_job -m "Failed executing commands"
+     stop
+endif
+LogAction -n switch1 -a Command_job -m "Completed executing commands"
+end</code>
+==== Debugging scenario execution ====
+When using the various levels of verbosity more detailed debugging information is displayed, as well as the parameters and the parsed script as shown above for reference purposes.
+<code>
+$ /opt/yce/bin/tasker2.pl -l -j 0322_0002 -o 'xml' -d 2
+JobID: 0322_0002
+Parsing scenario:
+[Scenario]
+Description switch1 Command_job...
+Description Command_job on switch1
+Import_cfg -q -n switch1 -f switch1.cmd -v
+if <error>
+     LogAction -n switch1 -a Command_job -m "Failed executing commands"
+     stop
+endif
+LogAction -n switch1 -a Command_job -m "Completed executing commands"
+end
+-Description (switch1 Command_job...)
+-Description (Command_job on switch1)
+   Establishing new session 'mgmt' for 'switch1'
+   == Start for 'mgmt' to 'switch1'
+   -- Start - reachable
+-03-22 10:32:21 Unreachable 'switch1': Address(es) not reachable at ports '23 '
+   Session 'switch1' mgmt at '198.172.0.3' was aborted
+   Action 'Start - reachable' aborted: Scenario stopped
+      Start done (1)
+ERROR: 'import_cfg' failed:
+      Session 'switch1 - ' not found
+-Function (Import_cfg -q -n switch1 -f switch1.cmd -v)
+-If (if <error>)
+      runtime '1' ==> true (1)
+      Condition = true (level=1)
+      'logaction' ok
+-Function (LogAction -n switch1 -a Command_job -m "Failed executing commands")
+-Stop: job finished
+-03-22 10:32:21 ABORTED after 15 seconds
+</code>