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).

The <version#> below is the release train version and release number of the package you choose.

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

For more information on choosing a package see: Which YumaPro Release Train Should I Use?

  • yumapro-sdk-<version#>

    • This package contains the full SDK without POSIX pthreads supported

  • yumapro-pthreads-<version#>

    • This package contains the full SDK with POSIX pthreads supported

  • yumapro-snmp-<version#>

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

There is also a package to install the YumaPro SDK documentation.

  • yumapro-doc-<version#>

    • This package contains the YumaPro SDK documentation (except Linux “man” files).

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 and CPU Architectures

Each Linux-specific binary package (except yumapro-docs) 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.

YumaPro SDK Basic Documentation

If you need to install the documentation go to the YumaPro SDK Basic Documentation section of Download YumaPro SDK Basic and download the documentation package that matches the operating system you are using.

Ubuntu version:

mydir> sudo dpkg -i yumapro-doc_20.10-12_all.deb

Fedora version:

mydir> sudo dnf install yumapro-doc-20.10-12.noarch.rpm

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

docs

Contains the YumaPro SDK Documentation set for the latest release in each release train. The HTML and PDF files are provided here for WEB access. Use the yumapro-doc package to install the complete document set.

There is a sub-directory here for each release train, back to 17.10. Choose the directory that matches the release train you need. There are "html" and "pdf" directories In each release-train directory.

training

Contains some NETCONF and YANG tutorial information.

yumapro-doc

Contains an archive of YumaPro SDK Documentation packages. There is a directory for each release (e.g. 21.10-2). There are RPM and Debian packages in each folder.

Binary SDK Variants

There are several yumapro 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).

The following packages are available:

  • yumapro-gnmi

    • Contains the yp-gnmi server distribution

  • yumapro-pthreads

    • Contains YumaPro SDK packages. This version is multi-threaded and requires POSIX Threads. Contains the yp-client Programming Libraries.

  • yumapro-sdk

    • Contains the YumaPro SDK packages. This version is single threaded and does not use POSIX Threads.

  • yumapro-sdk-basic

    • Contains the YumaPro SDK Basic packages. This version is single threaded and does not use POSIX Threads.

  • yumapro-snmp

    • Contains the yp-snmp server distribution

  • yumapro-tools

    • Contains the YumaPro SDK tools package This version is multi-threaded and requires POSIX Threads. Contains the yp-client Programming Libraries.

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.

If you need to install the documentation go to yumapro-doc and download the documentation that matches the version and release number of the SDK package you installed.

Ubuntu version:

mydir> sudo dpkg -i yumapro-doc_17.10-1_all.deb

Fedora version:

mydir> sudo dnf install yumapro-doc-17.10-1.noarch.rpm

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