Openss7 Installation and Reference Manual
Total Page：16
File Type：pdf, Size：1020Kb
OpenSS7 Installation and Reference Manual OpenSS7 Installation and Reference Manual Version 1.1 Edition 7.20141001 Updated October 25, 2014 Distributed with Package openss7-1.1.7.20141001 Copyright c 2008-2014 Monavacon Limited All Rights Reserved. Abstract: This document is a Installation and Reference Manual containing technical details con- cerning the implementation of the OpenSS7 for OpenSS7. It contains recommendations on software architecture as well as platform and system applicability of the OpenSS7. Brian Bidulock <[email protected]> for The OpenSS7 Project <http://www.openss7.org/> Published by: OpenSS7 Corporation 1469 Jefferys Crescent Edmonton, Alberta T6L 6T1 Canada Copyright c 2008-2014 Monavacon Limited Copyright c 2001-2008 OpenSS7 Corporation Copyright c 1997-2000 Brian F. G. Bidulock All Rights Reserved. Unauthorized distribution or duplication is prohibited. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled [GNU Free Documentation License], page 202. Permission to use, copy and distribute this documentation without modification, for any purpose and without fee or royalty is hereby granted, provided that both the above copyright notice and this permission notice appears in all copies and that the name of OpenSS7 Corporation not be used in advertising or publicity pertaining to distribution of this documentation or its contents without specific, written prior permission. OpenSS7 Corporation makes no representation about the suitability of this documentation for any purpose. It is provided \as is" without express or implied warranty. Notice: OpenSS7 Corporation disclaims all warranties with regard to this documentation including all im- plied warranties of merchantability, fitness for a particular purpose, non-infringement, or title; that the contents of the document are suitable for any purpose, or that the implementation of such contents will not infringe on any third party patents, copyrights, trademarks or other rights. In no event shall OpenSS7 Corporation be liable for any direct, indirect, special or consequential dam- ages or any damages whatsoever resulting from loss of use, data or profits, whether in an action of contract, negligence or other tortious action, arising out of or in connection with any use of this document or the performance or implementation of the contents thereof. i Short Contents Preface ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 1 Quick Start Guide ::::::::::::::::::::::::::::::::::::::::::::::: 11 1 Introduction :::::::::::::::::::::::::::::::::::::::::::::::: 19 2 Overview:::::::::::::::::::::::::::::::::::::::::::::::::::: 21 3 Reference ::::::::::::::::::::::::::::::::::::::::::::::::::: 25 4 Development :::::::::::::::::::::::::::::::::::::::::::::::: 45 5 Conformance :::::::::::::::::::::::::::::::::::::::::::::::: 59 6 Releases::::::::::::::::::::::::::::::::::::::::::::::::::::: 61 7 Installation :::::::::::::::::::::::::::::::::::::::::::::::: 109 8 Troubleshooting :::::::::::::::::::::::::::::::::::::::::::: 191 Licenses :::::::::::::::::::::::::::::::::::::::::::::::::::::::: 201 Indices ::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 225 iii Table of Contents Preface:::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 1 Notice ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 1 Abstract ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 1 Objective ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 1 Intent :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 1 Audience ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 1 Revisions :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 1 Version Control ::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 2 ISO 9000 Compliance ::::::::::::::::::::::::::::::::::::::::::::::::::: 2 Disclaimer ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 2 U.S. Government Restricted Rights ::::::::::::::::::::::::::::::::::::: 2 Acknowledgements ::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 3 Sponsors ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 3 Contributors:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 3 Supporters ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 4 Telecommunications ::::::::::::::::::::::::::::::::::::::::::::::::: 4 Aerospace and Military :::::::::::::::::::::::::::::::::::::::::::::: 5 Financial, Business and Security ::::::::::::::::::::::::::::::::::::: 5 Education, Health Care and Nuclear Power :::::::::::::::::::::::::: 6 Agencies:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 6 Authors:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 7 Maintainer ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 7 Web Resources ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 7 Quick Start Guide :::::::::::::::::::::::::::::::::::::::::::: 11 OpenSS7 ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 11 Release :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 11 Repository Installation :::::::::::::::::::::::::::::::::::::::::::::::: 12 Build Prerequisites :::::::::::::::::::::::::::::::::::::::::::::::::::: 14 Installation :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 15 Brief Installation Instructions :::::::::::::::::::::::::::::::::::::::::: 16 Detailed Installation Instructions :::::::::::::::::::::::::::::::::::::: 17 1 Introduction ::::::::::::::::::::::::::::::::::::::::::::::: 19 1.1 Objective :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 19 1.2 Organization of this Manual ::::::::::::::::::::::::::::::::::::::::: 19 1.3 Conventions and Definitions:::::::::::::::::::::::::::::::::::::::::: 19 2 Overview :::::::::::::::::::::::::::::::::::::::::::::::::: 21 2.1 Background:::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 21 2.2 Package Contents :::::::::::::::::::::::::::::::::::::::::::::::::::: 21 iv OpenSS7 3 Reference :::::::::::::::::::::::::::::::::::::::::::::::::: 25 3.1 Components ::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 25 3.2 Files::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 26 3.2.1 Kernel Modules::::::::::::::::::::::::::::::::::::::::::::::::: 26 3.2.1.1 STREAMS :::::::::::::::::::::::::::::::::::::::::::::::: 26 3.2.1.2 TTY :::::::::::::::::::::::::::::::::::::::::::::::::::::: 28 3.2.1.3 XNS :::::::::::::::::::::::::::::::::::::::::::::::::::::: 29 3.2.1.4 XNET::::::::::::::::::::::::::::::::::::::::::::::::::::: 29 3.2.1.5 SOCK::::::::::::::::::::::::::::::::::::::::::::::::::::: 29 3.2.1.6 INET ::::::::::::::::::::::::::::::::::::::::::::::::::::: 30 3.2.1.7 SCTP ::::::::::::::::::::::::::::::::::::::::::::::::::::: 30 3.2.1.8 CHAN :::::::::::::::::::::::::::::::::::::::::::::::::::: 31 3.2.1.9 X25 ::::::::::::::::::::::::::::::::::::::::::::::::::::::: 31 3.2.1.10 ISO :::::::::::::::::::::::::::::::::::::::::::::::::::::: 32 3.2.1.11 ISDN :::::::::::::::::::::::::::::::::::::::::::::::::::: 32 3.2.1.12 ATM ::::::::::::::::::::::::::::::::::::::::::::::::::::: 33 3.2.1.13 SS7 :::::::::::::::::::::::::::::::::::::::::::::::::::::: 33 3.2.1.14 SIGTRAN ::::::::::::::::::::::::::::::::::::::::::::::: 34 3.2.1.15 VOIP :::::::::::::::::::::::::::::::::::::::::::::::::::: 35 3.3 Drivers :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 35 3.4 Modules ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 35 3.5 Libraries::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 36 3.5.1 Shared Object Libraries::::::::::::::::::::::::::::::::::::::::: 36 3.5.2 Dynamic Loadable Modules ::::::::::::::::::::::::::::::::::::: 36 3.5.3 SNMP Modules::::::::::::::::::::::::::::::::::::::::::::::::: 36 3.6 Utilities ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 37 3.6.1 Init Scripts ::::::::::::::::::::::::::::::::::::::::::::::::::::: 37 3.6.2 Administrative Utilities ::::::::::::::::::::::::::::::::::::::::: 38 3.6.3 Performance Test Programs ::::::::::::::::::::::::::::::::::::: 40 3.6.4 Conformance Test Programs :::::::::::::::::::::::::::::::::::: 40 4 Development :::::::::::::::::::::::::::::::::::::::::::::: 45 4.1 Header Files ::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 45 4.1.1 User Space Programs ::::::::::::::::::::::::::::::::::::::::::: 45 4.1.1.1 STREAMS User Header Files :::::::::::::::::::::::::::::: 45 4.1.1.2 Terminal User Header Files :::::::::::::::::::::::::::::::: 45 4.1.1.3 Socket User Header Files :::::::::::::::::::::::::::::::::: 45 4.1.1.4 X/Open Network Services Header Files :::::::::::::::::::: 46 4.1.1.5 XTI/TLI Header Files ::::::::::::::::::::::::::::::::::::: 46 4.1.1.6 X.25 Header Files ::::::::::::::::::::::::::::::::::::::::: 46 4.1.1.7 APLI Header Files::::::::::::::::::::::::::::::::::::::::: 47 4.1.2 Kernel Space Drivers and Modules :::::::::::::::::::::::::::::: 47 4.1.2.1 STREAMS System Header Files ::::::::::::::::::::::::::: 47 4.1.2.2 Socket System Header Files :::::::::::::::::::::::::::::::: 48 4.1.2.3 Terminal System Header Files ::::::::::::::::::::::::::::: 48 4.1.2.4 XTI/TLI System Header Files ::::::::::::::::::::::::::::: 49 4.2 Libraries:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::