orbd(1)                                                                orbd(1)



NAME
       orbd - Object Request Broker Daemon

SYNOPSIS
       orbd [ options ]

DESCRIPTION
       The  orbd  tool  is  used to enable clients to transparently locate and
       invoke persistent objects on servers in the CORBA environment. The per-
       sistent  servers,  while publishing the persistent object references in
       the Naming Service, include the port number of the ORBD in  the  object
       reference  instead  of  the port number of the Server. The inclusion of
       the ORBD port number in the object reference for persistent object ref-
       erences has the following advantages:

       ]o The object reference in the Naming Service remains independent of the
         server life cycle. For example, the object reference  could  be  pub-
         lished  by  the  server  in  the  Naming  Service  when  it  is first
         installed, and then, independent of how  many  times  the  server  is
         started  or shut down, the ORBD will always return the correct object
         reference to the invoking client.

       ]o The client needs to look up the object reference in the  Naming  Ser-
         vice  only  once,  and can keep reusing this reference independent of
         the changes introduced due to server life cycle.

       The orbd tool incorporates the following functionality:

       ]o Server Manager

         When used in conjunction with the servertool(1), the  Server  Manager
         locates,  registers,  and  activates  a server when a client wants to
         access the server.

       ]o Server Manager

         When used in conjunction with the servertool(1), the  Server  Manager
         locates,  registers,  and  activates  a server when a client wants to
         access the server.

       ]o Interoperable Naming Service (INS)

         The naming service maps logical names to object  references  so  that
         you  can  use  the  name  to retrieve the object reference and invoke
         operations on that object. ORBD is used instead of the Transient Nam-
         ing Service, tnameserv(1). ORBD includes both a Transient Naming Ser-
         vice and a Persistent Naming Service.

       ]o Bootstrap Name Server

         The persistent servers publish their object references in  this  Name
         Server.  The clients can, in turn, contact this Name Server for look-
         ing up the object references. The advantage of providing  this  boot-
         strap  name  server  as part of ORBD is that the user doesn't need to
         start an additional Name Server process for publishing and  resolving
         object references.

       The  ORBD  works  with  the  servertool(1),  which is used to register,
       unregister, and list server information.

OPTIONS
       The following options are supported:

       -port port
              (Optional) Specifies the activation port where the  ORBD  should
              be  started.  The default value for this port is 10049. This port
              number is added to the port field of the persistent IORs.

       -defaultdb directory
              (Optional) Specifies the base where the ORBD persistent  storage
              directory  orb.db  is  created. If this option is not specified,
              the default value is "./orb.db".

       -serverid ID
              (Optional) Specifies the persistent server ID to be assigned  to
              this ORBD. The default value is 1.

       -ORBInitialPort nameserverport
              (Required) Specifies the port on which the bootstrap name server
              is running. Notice that when using Solaris  software,  you  must
              become  root  to  start a process on a port under 10024. For this
              reason, we recommend that you use a port number greater than  or
              equal to 10024.

       -ORBInitialHost  nameserverhost
              (Required) Specifies the host on which the bootstrap name server
              is running.

       -serverPollingTime milliseconds
              Specifies how often the daemon thread checks for the  health  of
              registered  servers.  ORBD  polls process health every millisec-
              onds. The default value is 1,,000000 ms (or  1  second).  The  value
              specified for milliseconds must be a valid integer.

       -serverStartupDelay milliseconds
              Specifies  how  long  the  Serveranager  waits before sending a
              location forward exception after the server is  restarted.  ORBD
              waits  for milliseconds before raising a location forward excep-
              tion. The default value is 1,,000000 ms (or  1  second).  The  value
              specified for milliseconds must be a valid integer.

       -Joption
              Pass  option to the Java virtual machine, where option is one of
              the options described on the man page for the  java  application
              launcher, java (1). For example, -J-Xms48m sets the startup mem-
              ory to 48 megabytes. It is a common convention for  -J  to  pass
              options to the underlying virtual machine.

ENVIRONMENT VARIABLES
       CLASPATH
              Used  to provide the system with a path to user-defined classes.
              Directories are separated by colons. For example:

              .::/Users/vlh/classes::/Library/Java/Home/Extensions

SEE ALSO
       java(1), javac(1), servertool(1)

       See (or search java.sun.com) for the following:

       Setting the Classpath @
              http:/java.sun.com/j2se/1.4/docs/tooldocs/solaris/classpath.html



                                  23 Apr 2001                          orbd(1)