
== Connexion install and usage ==

=== On ALT Linux ===

With Sisypus or branch/4.0 repository run update and install:

{{{
# apt-get update
# apt-get install connexion-full
}}}

This commands will install a system service and all deps --
Connexion engine, shell client and all modules.

=== On other systems ===

If there are no binary packages for your system, you can
build it from sources. It requires for minimal setup:

 * python 2.4 or 2.5

If you want to obtain extended readline support, you should
also have in your system:

 * python-devel (python headers files)
 * readline header files
 * gcc (to compile xreadline lib)
 * GNU make

To get modules-events working, you should get installed:

 * python-module-pysnmp4
 * python-module-pyasn1
 * python-module-pysnmp-mibs

The Connexion core will use one of these programs to
generate UUIDs:

 * python-module-egenix-mx-experimental:
	http://www.egenix.com/files/python/eGenix-mx-Extensions.html
	(please check it up in your distro repository at first)
 * uuidgen

If none found, it will use plain incremental IDs.

{{{
### install process
### checkout sources and read docs
$ svn co svn://radlinux.org/radlinux/branches/0.4.6
$ cd 0.4.6
$ less docs/README

### make xreadline library
$ pushd lib
$ make
$ popd

### run Connexion without installation
$ cd shell
$ export PYTHONPATH="../lib/cxcore/:../lib/cxnet/:../lib/cxutil/"
$ ./connexion.py -x \
	-w ncsh:../modules/ \
	-w system:../modules-system/ \
	-W basedict:../modules-basedict/ \
	-W events:../modules-events/ \
	-W heartbeat:../modules-heartbeat/ \
	-N bala -m 127.0.0.1 -k sample_psk -D debug -l ~/tmp/log

### run a client: in other console
$ cd interfaces/console
$ ./console.py

## install
# make install
}}}

== Connexion startup scheme ==

It is possible to run multiple connexion instances simultaneously. 
Each copy may be defined by the following set of files in the directory
/etc/connexion/$instance:

 * cmd -  command line parameters, excluding -s and -l which are formed on
          the basis of instance name
 * tree - tree commands.

List of connexion instances launched with `/etc/rc.d/init.d/connexion start`
is taken from file /etc/sysconfig/connexion.

By default connexion-cli tries to connect to an instance mentioned first.
