Working with a distributed client (using Pyro)
==============================================

In some circumstances, it is practical to split the repository and
web-client parts of the application, for load-balancing reasons. Or
one wants to access the repository from independant scripts to consult
or update the database.

For this to work, several steps have to be taken in order.

You must first ensure that the apropriate software is installed and
running (see ref:`setup`)::

  pyro-nsd -x -p 6969

Then you have to set appropriate options in your configuration. For
instance::

  pyro-server=yes
  pyro-ns-host=localhost:6969

  pyro-instance-id=myinstancename

Finally, the client (for instance in the case of a script) must
connect specifically, as in the following example code:

.. sourcecode:: python

    from cubicweb import dbapi

    def pyro_connect(instname, login, password, pyro_ns_host):
        cnx = dbapi.connect(instname, login, password, pyro_ns_host)
        cnx.load_appobjects()
        return cnx

The 'cnx.load_appobjects()' line is optional. Without it you will get
data through the connection roughly as you would from a DBAPI
connection. With it, provided the cubicweb-client part is installed
and accessible, you get the ORM goodies.