Apt Repositories

A number of OpenSS7 DEB repositories are set up as apt repositories suitable for use with apt(8), or other software installation and update tools that understand the apt repository format.

Instructions for setting up and using the apt(8) repositories follow:

Apt Setup

To set up for use of the apt(8) repositories, follow these steps:

Step 1. Install OpenSS7 CA Certificate

Registration for OpenSS7 repository access requires installation of the OpenSS7 CA Certificate. Simply click OpenSS7 CA Certificate and assign the certificate trust to identify websites.

Step 2. Register for Repository Access

All OpenSS7 repository access requires authentication. To register for a repository username and password, go to the registration page. The username and password obtained through registration will be required in Step 4. Note that the repository access password is separate and distinct from your web access password.

If you have already been assigned or registered for repository access credentials, you can skip this step.

Step 3. GPG Key Import

To use apt(8) to install or upgrade from the OpenSS7 apt(8) repositories, you will first need to import the OpenSS7 GPG software key (if not already imported), as follows:

$> sudo apt-key adv --fetch-keys http://www.openss7.org/pubkey.asc

Notes:

It is only necessary to import the GPG key once per machine installation.
You should import the GPG key first, because it will protect further http accesses.

Step 4. Repo Package Installation

For dpkg(8) based systems, it is necessary to download the repository package first and then install it using dpkg(8) from the command line. An example is as follows:

$> REPODIR=debs/debian/squeeze/amd64/main
$> REPODEB=openss7-repo_1.1.1.20110510-0_all.deb
$> wget http://www.openss7.org/repo/$REPODIR/$REPODEB
$> sudo dpkg -i $REPODEB
Authorization required for repository access:
Username: user
Password: ********
$> rm -f $REPODEB

Notes:

To obtain access to the repository at the level to which you are entitled, respond to Username: with your registered user name, and to Password: with your repository access password.
The repository access password is different than your web access password.
If you do not yet have a repository access password, see Step 2.
The example, above assumes that the distribution is debian, release squeeze, architecture amd64 and version 1.1.1.20110510.
For a list of other possible URLs to use, see below.

Repository Packages in the Apt Repository
Distro	Edition	Arch	Package

Note that not all registrants are entitled to access all of the repositories listed above. To find out which repositories you are entitled to access, log into your account.

Step 5. Test the Repository

It is easiest to test the repositories using a GUI package manager such as synaptic(1). Just select the package manager from the application menu and search for "openss7". To test the repository using the command-line apt(8) tools, follow the instructions below:

Update the installation sources, as follows:

$> sudo apt-get update

Next regenerate the apt caches, as follows:

$> sudo apt-cache gencaches

Finally, check that the openss7 packages are available, as follows:

$> apt-cache search openss7

Installation and Removal

Once the repository is set up by following the steps outlined above, it is then possible to use any package management GUI application on your system to install or remove the additional packages. All OpenSS7 packages have the string "openss7" in their names, so it is possible to search on openss7. The instructions that follow are for using the command line apt(8) tools.

OpenSS7 includes a number of virtual package definitions that ease the installation and removal of kernel modules, libraries and utilities. Installing for a single-kernel distribution is as easy as performing the following:

$> sudo apt-get install openss7

Removing the packages is as easy as performing (one of) the following:

$> sudo apt-get remove openss7
$> sudo apt-get purge openss7

To install the development packages for developing STREAMS modules and drivers, or applications that use the OpenSS7 Protocol Suites, install the development packages using:

$> sudo apt-get install openss7-devel

Installing and Removing the Runtime Packages

To install the OpenSS7 runtime packages necessary for running Linux Fast-STREAMS and the OpenSS7 Protocol Suites, install the openss7 package by performing the following:

$> sudo apt-get install openss7

To remove the OpenSS7 runtime packages (and all other OpenSS7 release packages with the exception of the openss7-repo package), perform the following:

$> sudo apt-get remove openss7
$> sudo apt-get purge openss7

Installing and Removing Java Packages

To install the OpenSS7 Java runtime packages, install the openss7-java package by performing the following:

$> sudo apt-get install openss7-java

To remove the OpenSS7 Java runtime packages, remove the openss7-java package by performing the following:

$> sudo apt-get remove openss7-java
$> sudo apt-get purge openss7-java

Both the installation and removal operations only affect the Java runtime packages and will not affect the other components of the release.

Installing and Removing Debug Packages

To install the OpenSS7 debug packages necessary for debugging Linux Fast-STREAMS and the OpenSS7 Protocol Suites, install the openss7-debuginfo and optionally the openss7-debugsource packages by performing the following:

$> sudo apt-get install openss7-debuginfo
$> sudo apt-get install openss7-debugsource

Note that not all registered users are entitled to access debugging source. To find out which components you are entitled to access, log into your account.

The OpenSS7 runtime will also be installed if it has not been installed already. These installation targets will also pull in the corresponding openss7-kernel-debuginfo and openss7-kernel-debugsource packages for the latest kernel.

To remove the OpenSS7 debugging information (without removing the runtime), perform the following:

$> sudo apt-get remove openss7-debuginfo
$> sudo apt-get purge openss7-debuginfo

This will remove all debug information and debug source packages, but will not affect the runtime packages.

Installing and Removing Development Packages

To install the OpenSS7 development packages necessary for compiling applications programs and STREAMS modules and drivers, perform the following:

$> sudo apt-get install openss7-devel

This will also install the kernel development package for the latest kernel. To install the kernel development package for an additional kernel, perform the following:

$> sudo apt-get install openss7-$(uname -r)-devel

The example, above, will install the development packages for the running kernel. You may substitute $(uname -r) with the version of the kernel for which you wish to install.

Installing and Removing Documentation

To install the OpenSS7 developer documentation, perform (one or both of) the following:

$> sudo apt-get install openss7-doc
$> sudo apt-get install openss7-javadoc

To remove the OpenSS7 developer documentation, perform (both of) the following:

$> sudo apt-get remove openss7-doc
$> sudo apt-get remove openss7-javadoc

Removing Everything

To remove all OpenSS7 packages, including the repository setup, perform the following:

$> sudo apt-get purge openss7-repo

This will remove all the OpenSS7 packages as well as the repository definitions. If you should have difficulties with the respository setup, removing the openss7-repo package and then installing it again might clear some issues.

Repository Layout

Some additional installation (real or virtual) package names and the installations or removals that they accomplish are as follows:

openss7-repo

This package contains the respository source and package updater information necessary to properly establish the OpenSS7 repository definitions for installing the other packages in the set.

openss7

This is a virtual package that contains the dependencies necessary for installing or removing the OpenSS7 release. The release includes kernel modules, STREAMS drivers, modules, libraries, utilities, test programs, daemons, and development environment for the development and execution of OpenSS7 drivers, components and applications for the STREAMS environment. This distribution is currently applicable to 2.6 and 3.x kernels and is validated for ix86, x86_64, ppc and ppc64 architectures, but should build and install well for other architectures.

This package can be used to install or remove all OpenSS7 packages. When installing, kernel modules will be installed automatically for the highest version kernel on your system. When removing, all corresponding kernel modules will also be removed.

openss7-base

This binary package contains the init scripts, test scripts, maintenance scripts and base system configuration files necessary for the operation of the protocol suites contained in the OpenSS7 distribution. It contains user and administration documentation in INFO, PDF and HTML ofrmats as well as sections 1, 4, 5 and 8 of the manual pages. This binary package is required for any installation of the OpenSS7 distribution.

openss7-doc

This binary package contains the documentation used in the development of applications and programs that use the distribution. It contains developer and programmer manuals in INFO, PDF and HTML formats as well as sections 2, 3, 7 and 9 of the manual pages. Install this binary package if you are interested in developing STREAMS drivers or modules or applications programs for the protocol suites contained in the OpenSS7 distribution. This binary package is massive and s not normally necessary except of a development system.

openss7-lib

This binary package contains the run-time (shared object) libraries necessary to run applications programs and utilities developed for OpenSS7. Also included are the libtool .la files describing the shared object libraries. The binary package also provides administrative and configuration test utilities and commands associated withe the OpenSS7 distribution. Note that these utilities are needed for running the validation test suites contained in the openss7-lib binary package.

openss7-compat

This binary package contains the 32-bit run-time (shared object) libraries necessary to run 32-bit application programs and utilities developed for OpenSS7. Als included are 32-bit test utilities for the OpenSS7 release. Note that these utilities are needed for running 32-bit validation test suites contained in the openss7-base binary package.

openss7-devel

This binary package contains library archives for static compilation, and head files to develop OpenSS7 applications, modules and drivers. This also includes the header files and static libraries required to compile OpenSS7 applications programs. This binary package does not contain devloper or programmer documentation nor manual pages. To obtain the developer and programmer documentation, load the openss7-doc binary package.

This package can be used to install or remove the development components of the OpenSS7 packages. When installing, openss7 and appropriate kernel modules and kernel module development and debug packages will also be installed. When removing, the development package and all kernel module development and debug packages will also be removed.

openss7-debuginfo

This binary package contains debuggin symbols for libraries and applications programs. This package provides debug information for binary package openss7-lib. Debug information is useful when developing applications that use this distribution or when debugging this distribution.

openss7-debugsource

This binary package contains source code for debugging libraries and applications programs. This package provides debug information for binary package openss7-lib. Debug information is useful when developing applications that use this distribution or when debugging this distribution.

openss7-java

This binary package contains JAIN implementations for OpenSS7. It includes jar files, JNI and CNI libraries, and gcj native compiled libraries. It also includes SWIG implementations of Java interfaces for OpenSS7 API libraries.

openss7-javadoc

This binary package contians Javadoc documentation for OpenSS7. Install this binary package if you are interested in developing JAIN applications or resource adaptors. This package is not normally required on other than a development system.

openss7-kernel

This virtual package is provided by each of the kernel-specific kernel module packages. The binary package providing this virtual package contains the kernel modules that provide the Linux kernel OpenSS7 drivers and modules. This includes assorted drivers and modules for STREAMS and additional OpenSS7 protocol suite components. The binary package also includes modprobe configuration files for the associated kernel modules. The binary package is weakly tied to the kernel for which it and dependent components were compiled. This package applies to a specific kernel version and requires dependent components compiled for a kernel with the same kABI. If you cannot find a binary package that matches your kernel, rebuild for your kernel from the openss7 package source DSC.

This package can be used to install or remove the packages for a specific kernel version. When installing, the openss7 package will also be installed if necessary. When removing the last kernel module packages, the openss7 pckages will also be removed.

Note that the version 2.4.20-28.7 is just an example. Use the version returned by $(uname -r) for the kernel for which you wish to install or remove packages.

openss7-kernel-devel

This virtual package is provided by each of the kernel-specific development packages. The binary package providing this virtual package contains the kernel module symbol information for development of additional STREAMS kernel modules against the core kernel modules included in the kernel-specific binary package. This package is weakly tied to the core kernel mdoules and kernel for which it was compiled. The binary package applies to core kernel modules for a specific kernel.

This package can be use to install or remove the development and debug packages for a specific kernel version. When installing, the openss7 and openss7-devel packages will also be installed if necessary. When removing, the development and debug for kernel modules for the last kernel, the openss7-devel packages will also be removed.

Note that the version 2.4.20-28.7 is just an example. Use the version returned by $(uname -r) for the kernel for which you wish to install or remove the packages.

openss7-kernel-debuginfo

This virtual package is provided by each of the kernel-specific debuginfo packages. The binary package providing this virtual package contains debugging symbols for kernel modules. This package provides debug information for the openss7-kernel package. Debug information is useful when developing kernel modules that use this distribution or when debugging this distribution.

openss7-kernel-debugsource

This virtual package is provided by each of the kernel-specific debugsource packages. The binary package providing this virtual package contains source code for debugging kernel modules. This package provides debugin formation for the openss7-kernel package. Debug information is useful when developing kernel modules that use this distribution or when debugging this distribution.

openss7-kernel-source

This virtual package is provided by each of the kernel-specific source packages. The binary package providing this virtual package contains the source code necessary for building the OpenSS7 release for a specific kernel version. It also includes the autoconf configuration utilities necessary to create and distribute this deb. However, to develop on the package, it would be better to use the tarball release. Load this package if you need some files from the build that are not present in the openss7-kernel-devel package.