YumaBench Software Instructions
- June 3, 2024
- YumaBench
Table of Contents
YumaBench Software
Preface
Legal Statements
- Copyright 2009 – 2012, Andy Bierman, All Rights Reserved.
- Copyright 2012 – 2021, YumaWorks, Inc., All Rights Reserved.
Additional Resources
Other documentation includes:
YumaBench User Manual
For issues installing or running YumaBench:
https://yumaworks.freshdesk.com/support/solutions/articles/1000299362
-issues-installing-yumabench.
Conventions Used in this Document
The following formatting conventions are used throughout this document:
Documentation Conventions
| Convention | Description |
|---|---|
| –foo | CLI parameter foo |
| < foo> | XML element foo |
| foo | yuma-bench command or parameter |
| $FOO | Environment variable FOO |
| some text | Example command or PDU |
| some text | Plain text |
| Informational text | Useful or expanded information |
| Warning text | Warning information indicating possibly unexpected side-effects |
Prerequisites
Your system will need access to the Internet to install YumaBench. You will need your system’s sudo permission or have your system administrator install YumaBench for you.
YumaBench is currently available on 64-bit versions of:
- Ubuntu 18.04 LTS and 20.04 LTS
- Debian 9 and 10
- Fedora 33 and 34
- CentOS 8
- Red Hat Enterprise Linux 8
- macOS Catalina and Big Sur
Linux System Preparation
The following steps are for the various supported Linux versions.
For .deb-based systems
The Yuma pro-installer package will install the Yuma bench-installer and
all the required packages for the installer and Yuma-bench to install and run.
For .deb-based Linux systems, Debian and Ubuntu, download the yumapro-
installer_
- sudo apt-get install ./<.deb package name>
- yumabench-linux-installer
At this point, the yumabench GUI Installer will run. To continue the installation instructions go to section “5 Installation”.
For CentOS systems
To prepare your CentOS Linux system you need to install two libraries. After that the YumaBench Installer will install everything else you need. To install these libraries perform the following on your system:
- sudo dnf install epel-release
- sudo dnf install libssh2
Then follow the steps in the next section to finish the installation.
For .rpm based systems
The yumapro-installer package will install the yumabench-installer and all the
required packages for the installer and Yuma-bench to install and run. For
.rpm-based Linux systems, Red Hat Enterprise Linux, CentOS and Fedora,
download the Yumapro-installer-
- sudo dnf install ./<.rpm package name>
- yumabench-linux-installer
At this point the yumabench GUI Installer will run. To continue the installation instructions go to section “5 Installation”.
macOS System Preparation
For macOS systems download the YumaBench_for_MacOS
If you see a popup message stating ‘Do you want to allow downloads on
“www.yumaworks.com”?’, select “Allow”.
In Finder locate the directory where the .zip file is located, by default this
will be Downloads, and double click on
YumaBench_for_MacOS
Double-click the folder to display the following contents:
- README
- Yuma-bench-installer
- yumabench-setup
The README contains the installation instructions.
Double-click the yumabench-setup icon or run ./yumabench-setup from a Terminal window. This will install and setup any of the following that are not already installed on your system:
- Homebrew
- qt5
- libssh2
- libxml2
macOS security steps
If you see a popup message stating that yumabench-setup ‘is from an
unidentified developer, select “OK”.
Then select “Apple | System Preferences…”, then select the “Security & Privacy” application icon.
In the message ‘“yumabench-setup” was blocked from use because it is not from
an identified developer.’, select “Open Anyway”.
You may need to double-click the yumabench-setup icon or run ./yumabench-setup from a Terminal window again if it does not restart automatically.
This will cause an “Are you sure you want to open it?” popup. Select “Open” to
start the Installer.
Then double click Yuma-bench-installer or run ./yuma-bench-installer from a Terminal window. You may have to repeat the section “4.1 macOS security steps” for the Yuma-bench-installer application. At this point, the yumabench GUI Installer will run.
Installation
The yumabench GUI Installer will install the necessary YumaBench components using the following screens:
This screen will appear. Select “Next”.
You will need to accept the license terms and then select “Next”. 
This screen will display what is going to be installed on your system and
where it will be installed. Select “Next”.
For Linux systems finishing the installation will require you to provide your
sudo privileges password to be able to install YumaBench on your system. Then
select “Finish”. On macOS there will be a Terminal status window that was
created when you launched the Installer, you may need to close the window
.
From a Terminal window you can now launch Yuma-bench with the following command:
- Yuma-bench
Details and instructions on how to use YumaBench can be found in the User Manual which is available here: YumaBench User Manual Once you have created a Device, a User, and a Session you can connect to any standard NETCONF server. You can use the free YumaPro SDK Basic NETCONF server. Download from here: YumaPro SDK Basic
References
- YANG-driven Automated Network Management Tools | YumaWorks
- Download YumaPro SDK Basic - YumaWorks
- Issues installing YumaBench : YumaWorks