home *** CD-ROM | disk | FTP | other *** search
/ Programming Languages Suite / JBuilder8.iso / Solaris / resource / jre / man / sman1 / orbd.1 < prev    next >
Encoding:
Text File  |  2002-09-06  |  10.0 KB  |  178 lines
  1. <!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
  2. <!--ArborText, Inc., 1988-1999, v.4002-->
  3. <!ENTITY % javaents SYSTEM "javaman.ent">
  4. %javaents;
  5. ]>
  6. <?Pub UDT _bookmark _target>
  7. <?Pub Inc>
  8. <refentry id="orbd-1">
  9. <!--@(#)orbd.1 1.1 01/03/14 SMI;-->
  10. <refmeta><refentrytitle>orbd</refentrytitle><manvolnum>1</manvolnum>
  11. <refmiscinfo class="date">23 Apr 2001</refmiscinfo>
  12. <refmiscinfo class="sectdesc">&man1;</refmiscinfo>
  13. <refmiscinfo class="software">&java-release;</refmiscinfo>
  14. <refmiscinfo class="arch">generic</refmiscinfo>
  15. <refmiscinfo class="copyright"> Copyright 2001 Sun Microsystems, Inc. All
  16. rights reserved.  Copyright 2001 Sun Microsystems, Inc. Tous droits réservés.
  17.  </refmiscinfo>
  18. </refmeta>
  19. <refnamediv><indexterm><primary sortas="orbd">orbd — Object Request
  20. Broker Daemon</primary></indexterm><indexterm><primary sortas="Object Request Broker Daemon">
  21. Object Request Broker Daemon — orbd</primary></indexterm><refname>orbd
  22. </refname><refpurpose>Object Request Broker Daemon</refpurpose></refnamediv>
  23. <refsynopsisdiv><title>&synp-tt;</title>
  24. <cmdsynopsis><command>orbd</command><arg choice="opt"> <replaceable>
  25. options</replaceable></arg>
  26. </cmdsynopsis></refsynopsisdiv>
  27. <refsect1><title>&desc-tt;</title>
  28. <para>The <command>orbd</command> tool is used to enable clients to transparently
  29. locate and invoke persistent objects on servers in the <acronym>CORBA</acronym>
  30. environment. The persistent servers, while publishing the persistent object
  31. references in the Naming Service, include the port number of the <acronym>
  32. ORBD</acronym> in the object reference instead of the port number of the Server.
  33. The inclusion of the <acronym>ORBD</acronym> port number in the object reference
  34. for persistent object references has the following advantages:<itemizedlist>
  35. <listitem><para>The object reference in the Naming Service remains independent
  36. of the server life cycle. For example, the object reference could be published
  37. by the server in the Naming Service when it is first installed, and then,
  38. independent of how many times the server is started or shut down, the <acronym>
  39. ORBD</acronym> will always return the correct object reference to the invoking
  40. client.</para></listitem>
  41. <listitem><para>The client needs to look up the object reference in the Naming
  42. Service only once, and can keep reusing this reference independent of the
  43. changes introduced due to server life cycle.</para></listitem>
  44. </itemizedlist></para>
  45. <para>The <command>orbd</command> tool incorporates the following functionality:<itemizedlist>
  46. <listitem><para><replaceable>Server Manager</replaceable><informalexample>
  47. <para>When used in conjunction with the <citerefentry><refentrytitle>servertool
  48. </refentrytitle><manvolnum>1</manvolnum></citerefentry>, the Server Manager
  49. locates, registers, and activates a server when a client wants to access the
  50. server.</para>
  51. </informalexample></para></listitem>
  52. <listitem><para><replaceable>Server Manager</replaceable><informalexample>
  53. <para>When used in conjunction with the <citerefentry><refentrytitle>servertool
  54. </refentrytitle><manvolnum>1</manvolnum></citerefentry>, the Server Manager
  55. locates, registers, and activates a server when a client wants to access the
  56. server.</para>
  57. </informalexample></para></listitem>
  58. <listitem><para><replaceable>Interoperable Naming Service (INS) </replaceable><informalexample>
  59. <para>The naming service maps logical names to object references so that you
  60. can use the name to retrieve the object reference and invoke operations on
  61. that object. <acronym>ORBD</acronym> is used instead of the Transient Naming
  62. Service, <citerefentry><refentrytitle>tnameserv</refentrytitle><manvolnum>
  63. 1</manvolnum></citerefentry>. <acronym>ORBD</acronym> includes both a Transient
  64. Naming Service and a Persistent Naming Service.</para>
  65. </informalexample></para></listitem>
  66. <listitem><para><replaceable>Bootstrap Name Server</replaceable><informalexample>
  67. <para>The persistent servers publish their object references in this Name
  68. Server. The clients can, in turn, contact this Name Server for looking up
  69. the object references. The advantage of providing this bootstrap name server
  70. as part of <acronym>ORBD</acronym> is that the user doesn't need to start
  71. an additional Name Server process for publishing and resolving object references.
  72. </para>
  73. </informalexample></para></listitem>
  74. </itemizedlist></para>
  75. <para>The <acronym>ORBD</acronym> works with the <citerefentry><refentrytitle>
  76. servertool</refentrytitle><manvolnum>1</manvolnum></citerefentry>, which is
  77. used to register, unregister, and list server information.</para>
  78. </refsect1>
  79. <refsect1><title>&opts-tt;</title>
  80. <para>The following options are supported:</para>
  81. <variablelist termlength="wholeline">
  82. <varlistentry><term remap="15"><option>port</option> <replaceable>port</replaceable></term>
  83. <listitem><para>(Optional) Specifies the activation port where the <acronym>
  84. ORBD</acronym> should be started. The default value for this port is <literal>
  85. 1049</literal>. This port number is added to the port field of the persistent <acronym>
  86. IOR</acronym>s.</para>
  87. </listitem></varlistentry>
  88. <varlistentry><term remap="15"><option>defaultdb</option> <replaceable>directory
  89. </replaceable></term><listitem><para>(Optional) Specifies the base where the <acronym>
  90. ORBD</acronym> persistent storage directory <literal>orb.db</literal> is created.
  91. If this option is not specified, the default value is "<literal>./orb.db</literal>".
  92. </para>
  93. </listitem></varlistentry>
  94. <varlistentry><term remap="15"><option>serverid</option> <replaceable>ID</replaceable></term>
  95. <listitem><para>(Optional) Specifies the persistent server <acronym>ID</acronym>
  96. to be assigned to this <acronym>ORBD</acronym>. The default value is <literal>
  97. 1</literal>.</para>
  98. </listitem></varlistentry>
  99. <varlistentry><term remap="15"><option>ORBInitialPort</option> <replaceable>
  100. nameserverport</replaceable></term><listitem><para>(Required) Specifies the
  101. port on which the bootstrap name server is running. Notice that when using
  102. Solaris software, you must become root to start a process on a port under <literal>
  103. 1024</literal>. For this reason, we recommend that you use a port number greater
  104. than or equal to <literal>1024</literal>.</para>
  105. </listitem></varlistentry>
  106. <varlistentry><term remap="15"><option>ORBInitialHost </option> <replaceable>
  107. nameserverhost</replaceable></term><listitem><para>(Required) Specifies the
  108. host on which the bootstrap name server is running.</para>
  109. </listitem></varlistentry>
  110. <varlistentry><term><option>serverPollingTime</option> <replaceable>milliseconds
  111. </replaceable></term><listitem><para>Specifies how often the daemon thread
  112. checks for the health of registered servers. <acronym>ORBD</acronym> polls
  113. process health every <replaceable>milliseconds</replaceable>. The default
  114. value is <literal>1,000</literal> ms (or <literal>1</literal> second). The
  115. value specified for <replaceable>milliseconds</replaceable> must be a valid
  116. integer.</para>
  117. </listitem></varlistentry>
  118. <varlistentry><term><option>serverStartupDelay</option> <replaceable>milliseconds
  119. </replaceable></term><listitem><para>Specifies how long the <literal>ServerManager
  120. </literal> waits before sending a location forward exception after the server
  121. is restarted. <acronym>ORBD</acronym> waits for <replaceable>milliseconds
  122. </replaceable> before raising a location forward exception. The default value
  123. is <literal>1,000</literal> ms (or <literal>1</literal> second). The value
  124. specified for <replaceable>milliseconds</replaceable> must be a valid integer.
  125. </para>
  126. </listitem></varlistentry>
  127. <varlistentry><term><option role="nodash">J</option><replaceable>option</replaceable></term>
  128. <listitem><para>Pass <replaceable>option</replaceable> to the Java virtual
  129. machine, where option is one of the options described on the man page for
  130. the java application launcher, java (1). For example, <literal>-J-Xms48m</literal>
  131. sets the startup memory to 48 megabytes. It is a common convention for <literal>
  132. -J</literal> to pass options to the underlying virtual machine.</para>
  133. </listitem></varlistentry><?Pub Caret>
  134. </variablelist></refsect1>
  135. <refsect1><title>&envr-tt;</title>
  136. <variablelist termlength="narrow">
  137. <varlistentry><term remap="15"><envar>CLASSPATH</envar> </term><listitem>
  138. <para>Used to provide the system with a path to user-defined classes. Directories
  139. are separated by colons. For example: <informalexample><para><literal>.:/home/avh/classes:/usr/local/java/classes
  140. </literal> </para>
  141. </informalexample></para>
  142. </listitem></varlistentry>
  143. </variablelist></refsect1>
  144. <refsect1><title>&attr-tt;</title>
  145. <para>See <citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>
  146. 5</manvolnum></citerefentry> for a description of the following attributes:
  147. </para>
  148. <informaltable frame="All" orient="Port">
  149. <tgroup cols="2" colsep="1" rowsep="1"><colspec colnum="1" colname="col1"
  150. colwidth="1*" colsep="1" align="Left"><colspec colnum="2" colname="col2" colwidth="1*"
  151. align="Left">
  152. <thead>
  153. <row><entry colname="col1" align="center" valign="top">ATTRIBUTE TYPE</entry>
  154. <entry colname="col2" align="center" valign="top">ATTRIBUTE VALUE</entry>
  155. </row>
  156. </thead>
  157. <tbody>
  158. <row><entry>Availability</entry><entry>SUNWj3dev</entry></row>
  159. </tbody>
  160. </tgroup>
  161. </informaltable>
  162. </refsect1>
  163. <refsect1><title>&also-tt;</title>
  164. <para><citerefentry><refentrytitle>java</refentrytitle><manvolnum>1</manvolnum>
  165. </citerefentry>, <citerefentry><refentrytitle>javac</refentrytitle><manvolnum>
  166. 1</manvolnum></citerefentry>, <citerefentry><refentrytitle>servertool</refentrytitle>
  167. <manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>attributes
  168. </refentrytitle><manvolnum>5</manvolnum></citerefentry> </para>
  169. <para>See (or search <literal>java.sun.com</literal>) for the following:</para>
  170. <variablelist termlength="wholeline">
  171. <varlistentry><term remap="10"><citetitle>Setting the Classpath</citetitle>
  172. @</term><listitem><para><ulink url="http://java.sun.com/j2se/1.4/docs/tooldocs/solaris/classpath.html">
  173. http://java.sun.com/j2se/1.4/docs/tooldocs/solaris/classpath.html</ulink></para>
  174. </listitem></varlistentry>
  175. </variablelist></refsect1>
  176. </refentry>
  177. <?Pub *0000010209>
  178.