Motorola 6806800C08B User Manual

NetPlane Core Services Overview

User’s Guide

6806800C08B

September 2007

2007 Motorola

Trademarks

Motorola and the stylized M logo are trademarks registered in the U.S. Patent and Trademark Office. All other product or service names are the property of their respective owners.

Intel

is a trademark or registered trademark of Intel Corporation or its subsidiaries in the United States and other countries.

™

and all other Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other

Java countries.

Microsoft Microsoft Corporation.

PICMG PCI Industrial Computer Manufacturers Group.

UNIX

, Windows® and Windows Me® are registered trademarks of Microsoft Corporation; and Windows XP™ is a trademark of

, CompactPCI®, AdvancedTCA™ and the PICMG, CompactPCI and AdvancedTCA logos are registered trademarks of the

is a registered trademark of The Open Group in the United States and other countries.

Notice

While reasonable efforts have been made to assure the accuracy of this document, Motorola assumes no liability resulting from any omissions in this document, or from the use of the information obtained therein. Motorola reserves the right to revise this document and to make changes from time to time in the content hereof without obligation of Motorola to notify any person of such revision or changes.

Electronic versions of this material may be read online, downloaded for personal use, or referenced in another document as a URL to a Motorola website. The text itself may not be published commercially in print or electronic form, edited, translated, or otherwise altered without the permission of Motorola,

It is possible that this publication may contain reference to or information about Motorola products (machines and programs), programming, or services that are not available in your country. Such references or information must not be construed to mean that Motorola intends to announce such Motorola products, programming, or services in your country.

Limited and Restricted Rights Legend

If the documentation contained herein is supplied, directly or indirectly, to the U.S. Government, the following notice shall apply unless otherwise agreed to in writing by Motorola.

Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (b)(3) of the Rights in Technical Data clause at DFARS 252.227-7013 (Nov. 1995) and of the Rights in Noncommercial Computer Software and Documentation clause at DFARS 252.227-7014 (Jun. 1995).

Contact Address

Motorola GmbH

ECC Embedded Communications Computing

Lilienthalstr. 15

85579 Neubiberg-Munich/Germany

About this Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

1.1 Avantellis 3000 Series Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

1.2 Avantellis 3000 Series Software Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

1.2.1 NetPlane Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

1.2.1.1 NetPlane Core Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

1.2.1.2 Platform Control Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

1.2.2 Carrier Grade Linux Operating System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

2 NetPlane Core Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

2.1 Architectural Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

2.1.1 NCS Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

2.1.2 Message Distribution Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

2.1.3 LEAP Portability Layer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

2.1.4 System Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

2.2 Distribution of NCS Services in the Avantellis System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

2.2.1 NCS Directors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

2.2.2 NCS Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

2.2.3 Sample Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

2.3 System Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

2.4 Management Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

2.5 SAF-Compliant NCS Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

2.5.1 Availability Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

2.5.1.1 Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

2.5.2 Checkpoint Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

2.5.2.1 Basic Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

2.5.2.2 Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

2.5.3 Message Queue Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

2.5.3.1 Basic Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

2.5.3.2 Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

2.5.4 Event Distribution Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

2.5.4.1 Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

2.5.5 Global Lock Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

2.5.5.1 Basic Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

2.5.5.2 Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

2.6 Motorola Complementary NCS Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

2.6.1 Distributed Tracing Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

2.6.1.1 Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

NetPlane Core Services Overview User’s Guide (6806800C08B)

Contents

2.6.2 HPI Integration Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

2.6.2.1 Basic Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

2.6.3 Simple Software Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

2.6.3.1 Basic Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

2.6.3.2 Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

2.6.4 System Resource Monitoring Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

2.6.5 Persistent Store-Restore Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

2.6.5.1 Basic Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

2.6.5.2 Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

2.6.6 Management Access Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

2.6.6.1 Basic Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

2.6.6.2 Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

2.6.7 Message-Based Checkpointing Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

2.6.7.1 Basic Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

2.6.7.2 Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

2.6.8 Interface Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

2.6.8.1 Basic Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

2.6.8.2 Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

2.7 Message Distribution Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

2.8 LEAP Portability Layer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

2.9 Implementation Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

2.9.1 Cancelling Application Threads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

A NCS Toolkit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

A.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

A.2 Toolkit Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

A.3 Toolkit Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

A.4 Building the Samples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

A.4.1 Development Host Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

A.4.2 "Make" Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

A.5 Running the Sample programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

A.5.1 Target Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

A.5.2 Setting LD_LIBRARY_PATH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

A.5.3 Running the Sample Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

B Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

B.1 Motorola Embedded Communications Computing Documents . . . . . . . . . . . . . . . . . . . . . . . . 51

B.2 Related Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

NetPlane Core Services Overview User’s Guide (6806800C08B)

List of Tables

Table 2-1 SAF Compliant NCS Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Table 2-2 Motorola-Complementary NCS Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Table 2-3 System Description Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Table B-1 Motorola Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Table B-2 Related Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

NetPlane Core Services Overview User’s Guide (6806800C08B)

List of Tables

NetPlane Core Services Overview User’s Guide (6806800C08B)

List of Figures

Figure 1-1 Avantellis Main Software Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Figure 2-1 NetPlane Core Services Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Figure 2-2 NCS Service Distribution - Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Figure 2-3 NCS Directors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Figure 2-4 NCS Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Figure 2-5 System Description - Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Figure 2-6 Management Access - Information Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Figure 2-7 Message Distribution Service Software Components . . . . . . . . . . . . . . . . . . . . . . . . . 42

NetPlane Core Services Overview User’s Guide (6806800C08B)

List of Figures

NetPlane Core Services Overview User’s Guide (6806800C08B)

About this Manual

Overview of Contents

This manual provides an overview on the Netplane Cores Services (NCS) software which is part of the Avantellis system software. It is divided into the following chapters and appendices.

z Chapter 1, Introduction, on page 13

Provides an overview of Avantellis and its main software components

z Chapter 2, NetPlane Core Services, on page 17

Descibes in more detail the components and functionality of the Netplane Core Services software which constitutes one of the most important components of the Avantellis software

z Appendix A, NCS Toolkit, on page 45

Describes toolkits that ease the application development.

z Appendix B, Related Documentation, on page 51

Provides references to related user manuals and standard documents

Abbreviations

This document uses the following abbreviations:

Abbreviation Definition

AIS Application interface specification

AMF Application Management Framework

API Application Programmer’s Interface

AvA Availability Agent

AvD Availability Director

AvND Availability Node Director

AvSv Availability Service

CEF Command Execution Functions

CGL Carrier Grade Linux

CKPT Checkpoint Service

CLI Command Line Interpreter

CLM Cluster Membership Service

CPA Checkpoint Agent

CPD Checkpoin Director

CPND Checkpoint Node Director

CPSv Checkpoint Service

NetPlane Core Services Overview User’s Guide (6806800C08B)

About this Manual

Abbreviation Definition

CSIs Component Service Instances

CPU Central Processing Unit

DHCP Dynamic Host Configuration Protocol

DTA Distributed Trace Agents

DTS Distributed Trace Server

DTSv Distributed Trace service

ECC Embedded Communications Computing

EDA Event Distribution Agent

EDS Event Distribution Server

EDSv Event Distribution Service

EVT Event service

FRU Field Replaceable Unit

FUF Firmware Upgrade Facility

GLA Global Locking Agent

GLD Global Locking Director

GLND Global Locking Node Director

GLSv Global Lock Service

HCD HPI Chassis Director

HISv HPI Integration Service

HPL HPI Adaption Private Library

HPM Hardware Platform Manager

IfA Interface Agents

IfD Interface Director

IfND Interface Node Director

IfSv Interface Service

LCK Locking Service

LEAP Layered Enhancement for Accelerated

Portability

LFM Local Fault Manager

MAA Managament Access Agent

MAS Management Access Server

MASv Management Access Service

MBCA Message Based Checkpoint Agent

MBCSv Message Based Checkpointing Service

MDS Message Distribution Service

MIB Management Information Base

MQA Message Queue Agent

NetPlane Core Services Overview User’s Guide (6806800C08B)

About this Manual

Abbreviation Definition

MQD Message Queue Director

MQND Message Queue Node Director

MQSv Message Queue Service

MSG Messaging Service

NCS NetPlane Core Services software

OAA Object Access Agent

PCS Platform Control Software

PSA Persistent Store Agent

PSS Persistent Store Server

PSSv Persistent Store Service

SAF Service Availability Forum™

SG Service Groups

SI Service Instances

SRMA System Resource Monitoring Agent

SRMND System Resource Monitoring Node Director

SRMSv System Resource Monitoring Service

SSU Simple Software Upgrade

SUND Simple Software Upgrade Node

SU Service Units

XML Extensible Markup Language

Conventions

The following table describes the conventions used throughout this manual.

Notation Description

0x00000000 Typical notation for hexadecimal numbers

0b0000 Same for binary numbers (digits are 0 and 1)

bold Used to emphasize a word Screen Used for on-screen output and code related

Courier + Bold Used to characterize user input and to

Reference Used for references and for table and figure

(digits are 0 through F), for example used for addresses and offsets

elements or commands in body text

separate it from system output

descriptions

File > Exit Notation for selecting a submenu

<text> Notation for variables and keys

NetPlane Core Services Overview User’s Guide (6806800C08B)

About this Manual

Notation Description

[text] Notation for software buttons to click on the

... Repeated item for example node 1, node 2,

screen and parameter description

..., node 12

.. Ranges, for example: 0..4 means one of the

| Logical OR

Summary of Changes

This manual has been revised and replaces all prior editions.

Part Number Edition Description

6806800C08A February 2007 First edition

6806800C08B September 2007 Added new section 2.9

Omission of information from example/command that is necessary at the time being

integers 0,1,2,3, and 4 (used in registers)

No danger encountered. Pay attention to important information

Comments and Suggestions

We welcome and appreciate your comments on our documentation. We want to know what you think about our manuals and how we can make them better.

Mail comments to:

z Motorola GmbH

Embedded Communications Computing Lilienthalstrasse 15 85579 Neubiberg Germany

z eccrc@motorola.com

In all your correspondence, please list your name, position, and company. Be sure to include the title, part number, and revision of the manual and tell how you used it.

NetPlane Core Services Overview User’s Guide (6806800C08B)

Introduction

1.1 Avantellis 3000 Series Overview

The Avantellis 3000 Series communications server represents the highest level of hardware and software integration to date within Motorola’s family of Open Application-Enabling Platforms.

It is built on the Centellis 3000 Series hardware platform which is an AdvancedTCA system characterized by the following:

z Redundant shelf manager and alarm modules (SAM)

z Redundant switching and system controller blades (ATCA-F101)

z Redundant power entry modules (PEM)

z Various node blades incl. accessories (ATCA-7107 and ATCA-7221) verified and

configured for the use within the Avantellis 3000 Series system

Avantellis 3000 Series uses this hardware platform and furthermore integrates the following software components to be used as basis for customer applications:

z NetPlane software

z Carrier Grade Operating System

This manual will focus on the Netplane Core Services (NCS) which is a component of the Netplane software. The purpose of this manual is only to provide an overview, information that is needed to actually use NCS for application development can be found in separate manuals. Links to these manuals are given in this manual wherever appropriate.

NetPlane Core Services Overview User’s Guide (6806800C08B)

Introduction Avantellis 3000 Series Software Architecture

1.2 Avantellis 3000 Series Software Architecture

The following figure illustrates the main software components which constitute an Avantellis 3000 Series system.

Figure 1-1 Avantellis Main Software Components

1.2.1 NetPlane Software

The NetPlane software can be subdivided into the NetPlane Core Services and the Platform Control Software.

1.2.1.1 NetPlane Core Services

NetPlane Core Services (NCS) is a suite of HA middleware which implements the Service Availability Forum™ (SAF) interface specification. The SAF is a consortium of industry-leading communications and computing companies working together to develop and publish high availability and management software interface specifications.

In addition to the services that implement the SAF interface, NCS contains complementary services that were introduced by Motorola and which are required in a a complete highavailability system solution.

Both the SAF-compatible services as well as the complementary services will be described in more detail in this manual.

1.2.1.2 Platform Control Software

Platform Control Software (PCS) is an hardware and operating system abstraction layer that was defined by Motorola. It comprises software components that are specific to the underlying hardware platform. On the other hand, PCS is hardware and OS agnostic and is therefore portable across various Avantellis product lines. PCS functionality also includes software that is responsible for the HA of hardware and OS specific software entities in the system.

NetPlane Core Services Overview User’s Guide (6806800C08B)

Carrier Grade Linux Operating System Introduction

NCS functionality is a service user of PCS functionality. However from another perspective, PCS is a service user of NCS since the HA of PCS software components is achieved through the HA services provided by NCS.

1.2.2 Carrier Grade Linux Operating System

In an Avantellis 3000 Series system the underlying operating system is Carrier Grade Linux (CGL) V. 4.0.1.

NetPlane Core Services Overview User’s Guide (6806800C08B)

Introduction Carrier Grade Linux Operating System

NetPlane Core Services Overview User’s Guide (6806800C08B)

+ 36 hidden pages