Manual installation of Blueworx packages

Note: All commands must be run as root, or as a user with root privileges using the sudo command.

If your Blueworx server does not have access to the internet, and therefore does not have access to the Blueworx Yum repository, you have two options to install the Blueworx packages:

Use an alternative server to download using Yum and copy RPMs to the Blueworx server and install (see instructions below); or
Contact Blueworx Support for direct download to RPMs and copy RPMs to the Blueworx server and install (see instructions below)

Yum RPM download

On an internet enabled RHEL based server, first install the downloadonly plugin for Yum:

yum install yum-plugin-downloadonly

Run the yum command, specifying the "--downloadonly" option:

yum install --downloadonly --downloaddir=/path/to/BlueworxRPMs package-name

Note: You can specify any directory on the "--downloaddir" option, /path/to/BlueworxRPMs is only an example.

The Blueworx packages are:

blueworx-vr - Blueworx Voice Response
blueworx-rm - Blueworx Resource Manager
blueworx-am - Blueworx Admin Manager
blueworx-sm - Blueworx Signalling Manager
blueworx-db - Blueworx Configuration Profile Database
blueworx-common - Common code and resources required by all components
blueworx-utils - Blueworx Utilities. This package contains additional applications and scripts to help administer your Blueworx environment, for example the Apache Kafka consumer for reading Call and Conference Detail Records (CDRs) and outputting these to a PostgreSQL database.

Download Blueworx GPG public key

The Blueworx RPM packages are signed using a GPG key. If you use Yum to install the Blueworx packages, this key is automatically downloaded and installed. With a manual install you will have to download and install this public key manually.

You can download the public key from here: https://yum.blueworx.com/keys/BLUEWORX-RPM-GPG-KEY

You can either download this onto an internet enabled Linux server using wget, or download to a workstation and transfer to your Blueworx server.

Installing on Blueworx server

Once you have downloaded the required packages and Blueworx GPG key, transfer them to the server you intend to install the Blueworx packages on.

Note: If you FTP the files, take care to transfer as binary files, not as ASCII text files, as this will corrupt the RPMs.

Installing the Blueworx GPG public key

You need to install the Blueworx GPG public key before installing any of the Blueworx packages. On the server you intend to install Blueworx on, run this command:

rpm --import /path/to/BLUEWORX-RPM-GPG-KEY

Now you have installed the Blueworx GPG public key, you can install the Blueworx RPM packages.

Installing Blueworx RPM packages

You can use Yum to install RPM files as follows.

Installing packages

To install a specific Blueworx package, specify the RPM file on the yum install command:

yum install /path/to/package.rpm

Updating packages

To update a specific Blueworx package, specify the RPM file on the yum update command:

yum update /path/to/package.rpm

Removing packages

To remove a specific Blueworx package, specify the package name (as listed above) on the yum remove command:

yum remove package-name

Note: You can use wildcards (*) on the yum install / update / remove commands. For example:

yum install /path/to/blueworx-*.rpm