Download PolyORB User's Guide

i
Table of Contents
About This Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
What This Guide Contains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1
Introduction to PolyORB . . . . . . . . . . . . . . . . . . 3
1.1
1.2
2
Distributed applications and middleware . . . . . . . . . . . . . . . . . . . . . . 3
PolyORB a generic middleware with an instance per distribution
model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.1
2.2
2.3
2.4
2.5
Supported Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Build requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Build instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Additional instructions for cross platforms. . . . . . . . . . . . . . . . . . . . .
Building the documentation and PolyORB’s examples . . . . . . . . . .
2.5.1 Build Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.5.2 Compiler, Tools and Run-Time libraries Options . . . . . . . . . .
2.6 Platform notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3
5
5
5
6
6
6
7
7
Overview of PolyORB personalities . . . . . . . . . 9
3.1
Application personalities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3.1.1 CORBA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3.1.2 Distributed System Annex of Ada (DSA) . . . . . . . . . . . . . . . . . 9
3.1.3 Message Oriented Middleware for Ada (MOMA) . . . . . . . . . . 9
3.1.4 Ada Web Server (AWS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3.2 Protocol personalities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3.2.1 GIOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
3.2.2 SOAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
4
Building an application with PolyORB . . . . . 11
4.1
Compile-time configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.1.1 Tasking run-times . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.1.2 Middleware tasking policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.1.3 Sample files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.2 Run-time configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.2.1 Using a configuration file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.2.2 Using environment variables . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.2.3 Using the command line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.3 Setting up protocol personalities . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.3.1 Activating/Deactivating protocol personalities . . . . . . . . . . .
4.3.2 Configuring protocol personality preferences . . . . . . . . . . . . .
4.4 Activating debug information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11
11
11
11
12
12
12
12
13
13
13
13