YumaPro Packages

There are several variants of YumaPro SDK in binary form. The installation is similar for all packages.

Packages are organized by release train (e.g., 19.10, 20.10, 21.10).

Note

  • The release train identifier represents the year and month of the initial release, similar to Ubuntu.

  • This numbering will change in a future release to use the YumaPro SEMVER numbering instead. This is more compliant with Linux packaging conventions.

  • The <version#> in the package name is the monthly version number

  • The first monthly release is in October (e.g., 23.10-1)

  • A snapshot release will be identified by its snapshot sequence (e.g. 23.10-1.1)

In most cases the latest version of the SDK should be used.

Binary Packages

There are several binary distributions available, depending on the license.

Refer to this feature comparison chart for details on the Basic, Core, and Advanced Feature Sets.

Within the YumaPro download site, there are several folders with the same structure.

  • There is a directory for each release (e.g. 21.10-3).

  • There is a directory for each platform in this directory (e.g., u1804). Select the package based on the required CPU architecture (e.g. amd64).

yumapro-sdk-basic

This is the free version of the SDK:

  • Basic Feature Set

  • No Posix Threads

yumapro-sdk-core

This is a paid version of the SDK:

  • Core Feature Set

  • No Posix Threads

yumapro-sdk

This is a paid version of the SDK:

  • Advanced Feature Set

  • No Posix Threads

yumapro-pthreads-basic

This is a paid version of the SDK:

  • Basic Feature Set

  • With Posix Threads

yumapro-pthreads-core

This is a paid version of the SDK:

  • Core Feature Set

  • With Posix Threads

  • With yp-client Support

yumapro-pthreads

This is a paid version of the SDK:

  • Advanced Feature Set

  • With Posix Threads

  • With yp-client Support

yumapro-snmp

This package contains the full SDK with the Simple Network Management Protocol (SNMP) supported.

  • Advanced Feature Set

  • No Posix Threads

  • SNMP Protocol

yumapro-gnmi

This package contains the full SDK with the gNMI and gRPC protocols supported.

  • Advanced Feature Set

  • No Posix Threads

  • Contains the yp-gnmi server distribution

Debian Packages

The Debian Packaging system is supported. Files with the ".deb" extension are Debian packages.

RPM Packages

The RPM Packaging system is supported. RPM packages are provided for selected platforms that do not support Debian Packages. Files with the ".rpm" extension are RPM packages.

Supported Linux Platforms

Each Linux-specific binary package is specific to a Linux distribution and CPU type.

The list of supported distributions and CPUs change over time. The current support is listed above, refer to Supported Distributions and Architectures

Installing YumaPro SDK Basic Binary Packages

Download the Correct YumaPro SDK Basic Package

In your browser navigate to Download YumaPro SDK Basic where you will find the list of currently available YumaPro SDK Basic Binary Packages.

Select the correct package for the operating system you are using. A new page will display the attributes of the package you have selected.

There is an option to sign up for the YumaPro User Newsletter that will provide you with ongoing information about YumaPro SDK Basic.

Select the Download button to begin the process of downloading your package. A license window will pop-up. Read the license to the end and an Accept Button will appear. Select the Accept Button and then select the new Download button. The standard Linux dialogue will then guide you to download the package.

Install the YumaPro SDK Basic Package

Navigate to the location where you saved the package. This will normally be in your ~/Downloads directory.

On Debian systems:

mydir> sudo dpkg -i yumapro-sdk-basic-20.10-12.2.u2004.amd64.deb

On RPM systems:

mydir> sudo dnf install yumapro-sdk-basic-20.10-12.2.fc34.x86_64.rpm

To quickly test the install run the server to just display its version:

> /usr/sbin/netconfd-pro --version

 Starting netconfd-pro...
 Copyright (c) 2008-2012, Andy Bierman, All Rights Reserved.
 Copyright (c) 2012-2021, YumaWorks, Inc., All Rights Reserved.

 netconfd-pro version 20.10-12.2-1fcb

 >

To see which files are installed in more detail refer to Appendix: Installed Files at the end of this document.

Installing YumaPro SDK Binary Packages

Download the Correct YumaPro Package

In your browser navigate to https://www.yumaworks.com/dld and login with the credentials YumaWorks provided to you.

Select a Package To Download

The root directory contains a number of directories, depending on your YumaPro license.

Documentation

Documentation is available online:

Install the Package

On Debian systems:

mydir> sudo dpkg -i yumapro-sdk-21.10-3.u1804.amd64.deb

On RPM systems:

mydir> sudo dnf install yumapro-sdk-21.10-3.fc34.x86_64.rpm

To quickly test the install run the server to just display its version:

> /usr/sbin/netconfd-pro --version

 Starting netconfd-pro...
 Copyright (c) 2008-2012, Andy Bierman, All Rights Reserved.
 Copyright (c) 2012-2021, YumaWorks, Inc., All Rights Reserved.

 netconfd-pro version 21.10-3-3fcf

 >

To see which files are installed in more detail refer to Appendix: Installed Files at the end of this document.

Installing YumaPro SDK from Source Code

To install YumaPro SDK from source files make sure you have installed the developer versions of the External Packages listed previously. Navigate to the YumaPro top level directory. You will find the file "README" that describes how to build YumaPro SDK and the build variables available. Below is an example. It is best to build, install, and if needed uninstall using the same build variables.

mydir> make EVERYTHING=1 USE_WERROR=1 DEBUG=1

mydir> sudo make install EVERYTHING=1 USE_WERROR=1 DEBUG=1

Note

If you have Server source code (e.g., yumapro-server2) you will not have access to the yangcli-pro/yp-shell source code and as such EVERYTHING=1 will not work.

You should: substitute EVERYTHING=1 for the features you want to include such as WITH_RESTCONF=1.

Refer to the YumaPro Source Code Guide for more details.

Uninstalling YumaPro SDK

If you need to uninstall YumaPro SDK see the article: How do I remove YumaPro SDK from my system?

Removing Files Not Needed By The Server

Installing yumapro-sdk and yumapro-pthreads SDK packages includes host platform developer tools that are not used by the server on a runtime platform. To remove these files see the article: Removing Files Not Needed by the Server