Using the Linux Binary Distributions

This page provides important information for users of the DataStorm binary distributions on Linux platforms. You can obtain these distributions at the ZeroC web site.

On this page:

Overview of the DataStorm Binary Distributions for Linux

DEB Packages

ZeroC provides the following DEB packages for Ubuntu or Debian:

PackageDescription
zeroc-datastormnodeThe dsnode executable
libzeroc-datastorm-devC++ header files and libraries
libzeroc-datastorm1.1C++ run-time libraries

RPM Packages

ZeroC provides the following RPMs for Red Hat Enterprise Linux and Amazon Linux:

RPMDescription
datastormnodeThe dsnode executable
libdatastorm-c++-develC++ header files and symbolic links to the C++ run-time libraries
libdatastorm1.1-c++C++ run-time libraries


Installing the Linux Distributions

This section describes how to install DataStorm binary packages for all of the supported Linux platforms.

Installing DataStorm on Ubuntu

Follow the instructions below to install DataStorm on Ubuntu.

1. Install ZeroC's key to avoid warnings with unsigned packages:

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv B6391CB2CFBA643D

2. Add the Ice and DataStorm repositories to your system:

sudo apt-add-repository "deb http://zeroc.com/download/ice/3.7/ubuntu22.04 stable main"
sudo apt-add-repository "deb http://zeroc.com/download/datastorm/1.1/ubuntu22.04 stable main"

3. Update the package list and install DataStorm:

sudo apt-get update
sudo apt-get install zeroc-datastormnode libzeroc-datastorm-dev libzeroc-datastorm1.1

Refer to the package summary if you would like to install fewer packages.

Installing DataStorm on Debian

Follow the instructions below to install DataStorm on Debian.

1. Install ZeroC's key to avoid warnings with unsigned packages:

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv B6391CB2CFBA643D

2. Add the Ice and DataStorm repositories to your system:

sudo apt-add-repository "deb http://zeroc.com/download/ice/3.7/debian11 stable main"
sudo apt-add-repository "deb http://zeroc.com/download/datastorm/1.1/debian11 stable main"

3. Update the package list and install DataStorm:

sudo apt-get update
sudo apt-get install zeroc-datastormnode libzeroc-datastorm-dev libzeroc-datastorm1.1

Refer to the package summary if you would like to install fewer packages.

Installing DataStorm on Red Hat Enterprise Linux 9

Follow the instructions below to install DataStorm on RHEL 9:

1. Add the Ice and DataStorm repositories to your system: 

cd /etc/yum.repos.d
sudo wget https://zeroc.com/download/ice/3.7/el9/zeroc-ice3.7.repo
sudo wget https://zeroc.com/download/datastorm/1.1/el9/zeroc-datastorm1.1.repo

2. Install DataStorm:

 sudo yum install datastormnode libdatastorm-c++-devel libdatastorm1.1-c++

Refer to the package summary if you would like to install fewer packages.

The yum documentation provides more information about installing packages on RHEL 9.

Setting Up your Linux Environment to Use DataStorm

After installing DataStorm, read the relevant language-specific sections below to learn how to configure your environment and start programming with DataStorm.

C++

When compiling and linking DataStorm for C++ programs, you must pass the -pthread option. A typical compile command would look like this:

c++ -c -std=c++11 -pthread myprogram.cpp

When linking a program you must link with at least the DataStorm library. A typical link command would look like this:

c++ -std=c++11 -o myprogram myprogram.o -pthread -lDataStorm -lIce++11

Using the Sample Programs

Sample programs for all programming languages are available in the DataStorm GitHub repository. Simply clone this repository:

git clone https://github.com/zeroc-ice/datastorm.git
cd datastorm/demos