summaryrefslogtreecommitdiff
path: root/ext/satellite/README
blob: 83aa6bba672fbacded24b0f741fd0d1ffd8c36d1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
$Id$

About Satellite
---------------
Satellite is CORBA support for PHP using ORBit.

The original version was made by David Eriksson <david@2good.com> 
during the summer 2000.


Installation
------------
Read below about installing ORBit.

Then create a directory on your server for your IDL files, and add
an entry to your php.ini like this:

  idl_directory = /var/idl

Note: If you compile Satellite as a dynamic PHP extension you must have the
      above line located before the extension=satellite.so line in php.ini!


Known issues
------------

The ORBit version required by Satellite does not properly handle an IOR that contains
a "Multiple Components Profile". If you run into these problems, please apply the patch
named 'multiple_components.patch' to your ORBit directory before building.

			
PHP as an Apache static module
------------------------------
Before linking Apache you must do either of these things:

  a) Before running Apache's configure you set the environment variable
     LIBS like this:

     export LIBS="`orbit-config --libs client` `libIDL-config --libs`"

  b) You edit apache/src/modules/php4/libphp4.module and
     add `orbit-config --libs client` `libIDL-config --libs`
     within the quotes on the line beginning with LIBS=


What version of ORBit is required?
----------------------------------
You need a CVS version of ORBit to use Satellite!

This does NOT work with ORBit 0.5.5 or earlier.

The latest CVS version of ORBit in CVS requires glib-2.0 and has not been 
tested. Because of this we checkout a CVS version from a known safe date.

How to install ORBit from CVS
-----------------------------

(1) Get it from CVS

    CVS root:   :pserver:anonymous@anoncvs.gnome.org:/cvs/gnome
    Password:   Empty string
    Directory:  ORBit
    Safe date:  2000-09-02 (yyyy-mm-dd)

    More about GNOME:s CVS on http://www.gnome.org/start/source.html

    Sample session at command line to checkout:

    $ export CVSROOT=":pserver:anonymous@anoncvs.gnome.org:/cvs/gnome"
    
    $ cvs login
    (Logging in to anonymous@anoncvs.gnome.org)
    CVS password:
    
    $ cvs checkout -D "2000-09-02" ORBit
    cvs server: Updating ORBit
    .
    .
    .

(2) Set the environment variable CERTIFIED_GNOMIE to whatever you like.

(3) Run ./autogen.sh, gmake and gmake install


How to install ORBit from snapshot
----------------------------------

(1) Download snapshot from one of these addresses:

    http://download.2good.nu/satellite/ORBit-20000902.tgz
    http://www.2good.com/satellite/ORBit-20000902.tgz

(2) Set the environment variable CERTIFIED_GNOMIE to whatever you like.

(3) Run ./configure, gmake and gmake install