YumaBench Installation Guide

YumaBench logo

Install YumaBench on a supported Linux, macOS, or Windows system. This guide walks you from download through first launch.

Note

Your computer must have Internet access during installation. You also need sudo or administrator permission. If you do not have that permission, ask your system administrator to install YumaBench.

Choose Your Platform

Supported operating systems

Platform

Supported versions

Installer

Linux

Ubuntu 22.04/24.04 LTS; Debian 12

yumapro-installer_1.3_amd64.deb

Linux

Fedora 39/40/41; CentOS Stream 9; Red Hat Enterprise Linux 9

yumapro-installer-1.3.0-1.x86_64.rpm

macOS

Sonoma; Apple silicon

yuma-bench-installer.dmg.zip

Windows

Windows 10 or 11, 64-bit

yuma-bench-installer.exe

Download YumaBench

The latest YumaBench software can be obtained from the YumaWorks Developer Portal.

Select the file you need and download it to your computer.

Install on Linux

Download the installer that matches your Linux distribution, open a terminal in the download directory, and follow these steps.

Install the Linux Package

Linux package commands

Package type

Command

Debian/Ubuntu (.deb)

sudo apt-get install ./yumapro-installer_1.3_amd64.deb

Fedora/CentOS/RHEL (.rpm)

sudo dnf install ./yumapro-installer-1.3.0-1.x86_64.rpm

When prompted to install dependent packages, type y and press Enter.

Enable EPEL When Required

On CentOS or Red Hat Enterprise Linux, the installer may report that packages are unavailable. Enable the EPEL repository, then repeat the dnf install command.

For CentOS Stream 9:

$ sudo dnf config-manager --set-enabled crb
$ sudo dnf install epel-release epel-next-release

For Red Hat Enterprise Linux 9:

$ sudo subscription-manager repos --enable codeready-builder-for-rhel-9-$(arch)-rpms
$ sudo dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm

Run the Linux Installer

After the package installation finishes, start the graphical installer:

$ yumabench-linux-installer

  1. On the Introduction screen, select Next.

  2. Accept the license agreement and select Next.

  3. On the Ready to Install screen, select Next.

  4. Enter your sudo password when prompted.

Launch YumaBench from the application menu, or run:

$ yuma-bench

Install on macOS

These instructions apply to macOS Sonoma on Apple silicon Macs.

Move the Installer to Applications

  1. Download yuma-bench-installer.dmg.zip.

  2. In Finder, open Downloads and expand the archive.

  3. Drag yuma-bench-installer into the Applications folder.

  4. Double-click yuma-bench-installer in Applications.

Moving the YumaBench installer into the macOS Applications folder

When macOS warns that the application was downloaded from the Internet, select Open.

macOS security warning with the Open button selected

Install macOS Dependencies

YumaBench requires Homebrew and openssl@3. If both are already installed, the installer continues automatically. Otherwise, it displays the command you need to run in Terminal.

YumaBench installer installing macOS dependencies

To install Homebrew:

$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

On Apple silicon, Homebrew may instruct you to add it to your PATH. Replace YOUR_USERNAME with your macOS account name:

$ (echo; echo 'eval "$(/opt/homebrew/bin/brew shellenv)"') >> /Users/YOUR_USERNAME/.zprofile
$ eval "$(/opt/homebrew/bin/brew shellenv)"

To install OpenSSL 3:

$ brew install openssl@3

Finish the macOS Installation

  1. Run yuma-bench-installer again after installing the dependencies.

  2. Select Next on the Introduction screen.

  3. Accept the license agreement and select Next.

  4. Review the dependency list and select Next.

  5. Enter your macOS password when prompted.

  6. Wait for the installer to confirm completion.

Launch YumaBench from the Applications folder or run yuma-bench in Terminal.

Install on Windows

  1. Download yuma-bench-installer.exe.

  2. Open the installer from the Downloads folder.

  3. On the Introduction screen, select Next.

  4. Accept or change the installation location, then select Next.

  5. Select the check box beside yuma-bench, then select Next.

  6. Accept the license agreement and select Next.

  7. Accept or change the Start Menu shortcuts and select Next.

  8. On Ready to Install, select Install.

  9. When installation completes, select Finish.

Launch YumaBench on Windows

Use any of these methods:

Windows launch methods

Method

Action

Desktop

Double-click the YW yuma-bench desktop icon.

Windows Search

Type yuma-bench in the Windows search box and select the application.

PowerShell or Command Prompt

Run the executable by its full path, for example C:\YumaBench\yuma-bench.exe.
Finding YumaBench with Windows Search

Add YumaBench to the Windows PATH

Adding the installation folder to PATH lets you run yuma-bench without typing its full location.

  1. Search Windows for advanced and open View advanced system settings.

  2. In System Properties, select Environment Variables.

  3. Under System variables, select Path, then select Edit.

  4. Select New, then Browse.

  5. Choose the YumaBench installation folder, such as C:\YumaBench.

  6. Select OK in each open dialog.

Open a new PowerShell or Command Prompt window and run yuma-bench.

Installation Troubleshooting

Installer Reports an Exec Format Error

Message:

bash: ./yuma-bench-installer: cannot execute binary file: Exec format error

This usually means that the installer's CPU architecture does not match the system. Confirm that the system architecture matches the downloaded installer and use one of the supported operating systems listed in Choose Your Platform.

Qt5Widgets Shared Library Is Missing

Message:

./yuma-bench-installer: error while loading shared libraries:
libQt5Widgets.so.5: cannot open shared object file: No such file or directory

The required Qt5 library is not installed. Install YumaBench with the platform package and command described in Install the Linux Package. The package installer checks for and installs the required dependencies.

Installer Reports an Unsupported Operating System

If the installer displays a pop-up stating that the operating system is not supported, stop the installation and use one of the 64-bit operating systems listed in Choose Your Platform.

SSH Shared Library Is Missing

Message:

yuma-bench: error while loading shared libraries: libssh2.so.1:
cannot open shared object file: No such file or directory

Only on CentOS or Red Hat Enterprise Linux - verify that EPEL is enabled as described in Enable EPEL When Required.

Required Yuma Modules Are Missing

If YumaBench displays a pop-up stating that required Yuma modules are missing, the installer may have been interrupted by a network connection error.

  1. Confirm that the computer has a working Internet connection.

  2. Close YumaBench.

  3. Run the YumaBench installer again.

  4. Start YumaBench after the installer completes successfully.

Other Common Problems

Additional installation issues

Problem

Resolution

Linux reports unavailable packages

On CentOS or RHEL, enable EPEL and repeat the package installation.

macOS installer stops for dependencies

Install Homebrew and openssl@3, add Homebrew to PATH if directed, and rerun the installer.

Windows cannot find yuma-bench

Launch it by full path or add the YumaBench installation folder to PATH.

Administrator access is unavailable

Ask your system administrator to perform the installation.

Next Steps

YumaBench is now ready to use. Consult the YumaBench User Manual for help connecting to a NETCONF server and using YumaBench features.