Library scope: | GLOBAL |
---|
Robot keyword library (Resource) for handling the BGP speaker Python utilities.
Copyright (c) 2015,2017 Cisco Systems, Inc. and others. All rights reserved.
This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html
This library assumes that a SSH connection exists (and is switched to) to a Linux machine (usualy TOOLS_SYSTEM) where the Python BGP speaker should be run. It also assumes that the current working directory on that connection is the directory where the speaker tool was deployed as there are no paths to neither the play.py nor the log files in the commands.
Aside BGP Speaker utility, there is also BGP Manager starting utilities in parallel. For purpose of dumping logs and killing, Manager behaves the same as Speaker.
TODO: RemoteBash.robot contains logic which could be reused here.
TODO: Update the following TODOs, as SSHKeywords.robot was introduced. TODO: The Utils.robot library has a "Run Command On Remote System" if we didn't want to make the assumption that an SSH connection was already open. alternative TODO: Explain that it is not worth to perform separate SSH logins.
Send all output produced by the play.py utility to Robot logs. This needs to be called if your suite detects play.py crashing and bypasses Kill_BGP_Speaker in that case otherwise the output of play.py (which most likely contains clues about why it crashed) will be lost.
Kill all play.py processes.
Interrupt play.py, fail if no prompt is seen within SSHLibrary timeout. Also dump the logs with the output the program produced. This keyword is also suitable for stopping BGP manager.
Start the BGP manager python utility. Redirect its error output to a log file.
Start the BGP speaker python utility. Redirect its error output to a log file so it can be dumped into the logs later, when stopping it. This also avoids polluting the output seen by "Read Until Prompt" with false propmpts so it won't stop prematurely leading to a spurious test failure, messy log content or other misbehavior.
Start the BGP speaker python utility, and verifies it's connection. We can change connected variable to false to verify Speaker did not connect.
Verifies peer's presence in bgp rib.