User guide

Installing RGS 67
Customized Audio Installation
The following remote audio installation process for Linux is used when the RGS Receiver is installed through the
./install.sh script. For those installations that require customization or need to use other features from the
rgs_audio_support script, here are additional details for its use.
The audio support bundle ships as hp_rgs_4_audiosupport.tar.gz. It is accessed by the RGS
install.sh script in /opt/hpremote or may be utilized for manual installations / RPM package building.
The install process requires a locally writable directory in which to build. Locate the support bundle in an
appropriate directory before installation. Use the following command to unpack the file manually if desired:
tar xzf hp_rgs_4_audiosupport.tar.gz
As the user root, change directory into the one created by the command above. It will contain important files such
as:
README.txt
— basic instructions and file manifest
rgs_audio_support — shell installation script for ALSA/JACK libraries
alsa-*.tar.bz2 — recently validated tar archives from the ALSA project (provided only for open source
requirements and legacy installations) — see http://alsa-project.org
jack-*.tar.gz — recently validated tar archives from the JACK-Audio-Connection-Kit project — see
http://jackit.sourceforge.net
libsndfile-*.tar.gz — recently validated tar archives from the libsndfile project (JACK dependency) —
see http://www.mega-nerd.com/libsndfile
The sample installation script, rgs_audio_support, offers three installation scenarios:
• install — This command unpacks all tar archives into a local build directory in the current directory
[./localroot ], configures, builds, and installs the required ALSA/JACK libraries appropriate for the host
system and active kernel. It is a good choice for local installations or system development. A system reboot is
recommended for best results.
• remove — This command removes and unconfigures an installation provided by the above install
command.
• build_rpms — This command runs an install command first, and then attempts to create a compatible set
of binary RPMs for installation on matched system configurations. This will greatly reduce the work of
enterprise administrators duplicating this install process across multiple nodes. After a successful build, the
following files are created:
./RPMS/*.rpms — binary RPMs copied from /usr/src/redhat/RPMS
./RPMS/RGS_audio_install.sh — customized install and configuration script to associate
with RPMs
NOTE: The build log created by this script is located in /var/log/hpaudio.log
NOTE: The sample installation script, rgs_audio_support, supports limited customization capabilities for newer source
deliveries as they become available. See the script internals for more details.