| 1 | <chapter id="configuring"> |
|---|
| 2 | <title>Configuring Bonobo Activation</title> |
|---|
| 3 | |
|---|
| 4 | <sect1> |
|---|
| 5 | <title>.server search path.</title> |
|---|
| 6 | <para> |
|---|
| 7 | To know the list of available CORBA servers on your local machine, the OAF daemon |
|---|
| 8 | searches a number of directories for .server XML files which contain the description |
|---|
| 9 | of the services offered by these servers. |
|---|
| 10 | By default, OAF will try to find them in ${prefix}/share/oaf which may be a problem |
|---|
| 11 | if users install other applications using OAF in different prefixes. |
|---|
| 12 | </para> |
|---|
| 13 | |
|---|
| 14 | <para> |
|---|
| 15 | To work around this problem, OAF will parse a number of other directories. |
|---|
| 16 | It will parse the directories listed in the OAF_INFO_PATH env variable. |
|---|
| 17 | It will parse the prefixes listed in the GNOME_PATH env variable. |
|---|
| 18 | If, for example, <emphasis>OAF_INFO_PATH=/opt/gnome/share/oaf:/opt/gnome/oaf/share/oaf</emphasis>, |
|---|
| 19 | OAF will parse <emphasis>/opt/gnome/share/oaf</emphasis> and <emphasis>/opt/gnome/oaf/share/oaf</emphasis> |
|---|
| 20 | If <emphasis>GNOME_PATH=/opt/gnome:/opt/gnome/oaf</emphasis>, OAF will parse |
|---|
| 21 | <emphasis>/opt/gnome/share/oaf</emphasis> and <emphasis>/opt/gnome/oaf/share/oaf</emphasis>. |
|---|
| 22 | </para> |
|---|
| 23 | |
|---|
| 24 | <para> |
|---|
| 25 | The above env variables are kept for compatibility purposes with older versions of |
|---|
| 26 | OAF and for GNOME integration. OAF has a much nicer configuration file which allows |
|---|
| 27 | you to control which directories are parsed by OAF. This XML configuration file |
|---|
| 28 | is located in ${prefix}/etc/oaf/oaf-config.xml. An empty oaf-config.xml and |
|---|
| 29 | a sample oaf-config.xml.sample file should be installed on your system. |
|---|
| 30 | </para> |
|---|
| 31 | |
|---|
| 32 | <para> |
|---|
| 33 | It is recommended to use the <emphasis>oaf-sysconf</emphasis> command-line configuration |
|---|
| 34 | tool to edit this file. However, here is an example of its format. |
|---|
| 35 | </para> |
|---|
| 36 | |
|---|
| 37 | <programlisting> |
|---|
| 38 | <?xml version="1.0"?> |
|---|
| 39 | |
|---|
| 40 | <oafconfig> |
|---|
| 41 | |
|---|
| 42 | <searchpath> |
|---|
| 43 | <item>/opt/gnome/share/oaf</item> |
|---|
| 44 | <item>/usr/local/gnome/share/oaf</item> |
|---|
| 45 | <item>/usr/local/share/oaf</item> |
|---|
| 46 | <item>/opt/gnome/oaf/share/oaf</item> |
|---|
| 47 | </searchpath> |
|---|
| 48 | |
|---|
| 49 | <searchpath> |
|---|
| 50 | <item>/opt/gnome/oaf/share/oaf</item> |
|---|
| 51 | </searchpath> |
|---|
| 52 | |
|---|
| 53 | </oafconfig> |
|---|
| 54 | </programlisting> |
|---|
| 55 | |
|---|
| 56 | <para>There can be any number of <item> tags in a <searchpath> tag and any number of |
|---|
| 57 | <searchpath tags in the <oafconfig> tag.</para> |
|---|
| 58 | |
|---|
| 59 | </sect1> |
|---|
| 60 | |
|---|
| 61 | </chapter> |
|---|
