Pacman Repositories

A number of OpenSS7 PKG repositories are set up as pacman repositories suiteable for use with pacman(8), or other software installation and update tools that understand the archlinux repository format, such as yaourt(8).

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

Pacman Setup

To set up for use of the pacman(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 pacman(8) to install or upgrade from the OpenSS7 pacman(8) repositories, you will first need to import the OpenSS7 GPG software key (if not already imported), as follows:

$> cd /usr/share/pacman/keyrings
$> sudo wget -O openss7.gpg     http://www.openss7.org/pubkey.asc
$> sudo wget -O openss7-trusted http://www.openss7.org/ptrust.txt
$> sudo pacman-key --populate openss7
$> sudo rm -f -- openss7.gpg openss7-trusted

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 pacman(8) based systems, it is necessary to download the repository package first and then install it using pacman(8) from the command line. An example is as follows:

$> REPODIR=pkgs/arch/os/x86_64
$> REPOPKG=openss7-repo_1.1.1.20110510-1-x86_64.pkg.tar.xz
$> yaourt -U http://www.openss7.org/repo/$REPODIR/$REPOPKG
Authorization required for repository access:
Username: user
Password: ********

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 archlinux, architecture x86_64 and version 1.1.1.20110510.
For a list of other possible URLs to use, see below.

Repository Packages in the PKG Repository
Distro	Edition	Arch	File	Depsolver

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 PackageKit(1). Just select the package manager from the application menu and search for "openss7". To test the repository using the command-line yaourt(8) tool, follow the instructions below:

Update the installation sources, as follows:

$> yaourt -Sy

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

$> yaourt -Ss 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 yaourt(8) tool.

OpenSS7 includes a number of groups and 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 one of the following:

$> yaourt -Ss openss7
$> yaourt -Ss openss7-linux-lts

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

$> yaourt -R openss7
$> yaourt -R openss7-base

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 or pattern by performing (one of) the following:

$> yaourt -Ss openss7
$> yaourt -Ss openss7-linux-lts

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

$> yaourt -R openss7
$> yaourt -R openss7-base

Installing and Removing Java Packages

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

$> yaourt -S openss7-java

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

$> yaourt -R 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

Archlinux does not normally package debug information separately from the the runtime packages. In fact, Archlinux does not normally distribute debug information at all (all binaries are fully stripped). Therefore, no special installation of debug packages is necessary or possible.

Installing and Removing Development Packages

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

$> yaourt -S 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:

$> yaourt -S openss7-linux-lts-devel

The example, above, will install the development packages for the linux-lts kernel. Note that the linux kernel is not currently supported.

Installing and Removing Documentation

Archlinux does not normally package documentation separately from runtime packages. Therefore, the documentation is included in the other packages and no special installation of documentation is necessary.

Removing Everything

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

$> yaourt -R 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

Several groups are provided in the category openss7-components as follows: