Examples

Several configuration examples follow, for typical and more elaborate cases. Each example shown is a full configuration file, not a part of a file.

Local install at the default directory (/usr/local/leanxcale):

host localhost

Local install with a single directory:

host localhost
    lxdir /ssd/leandata/xamplelx

It is strongly suggested to use the host name instead of localhost.

Install at hosts named blade124 and blade123 at the default directory:

host blade124
host blade123

Install at hosts named blade124 and blade123, default directory, but include monitoring subsystem (runs at the first host):

host blade124
    stats
host blade123

Install at hosts named blade124 and blade123, at /ssd/xamplelx:

lxdir /ssd/xamplelx
host blade124
host blade123

Install at hosts named blade124 and blade123, at /ssd/xamplelx:

host blade124
    lxdir /ssd/xamplelx
host blade123
    lxdir /ssd/xamplelx

Install at host blade124 placing there the kvms, (2 instances of) kvds, lxmeta, and lxqe components. Install a default configuration at blade123:

host blade124
    lxmeta
    lxqe
    kvms
    kvds x 2
host blade123

Install in two docker containers, lx1 and lx2:

docker
host lx1
host lx2

Install the lx command at the local host, without DB components, and install the host blade124 with a detailed configuration, and the host blade123 as a mirror of the former host (see the comments for details):

# use always ~/xamplelx to install
lxdir   $HOME/xamplelx

# we might just write this property, to configure ssh and scp
# in this example, we add explicit configuration for ssh and scp too.
blades

# How to execute a remote shell from here to machines listed
# Use {host} for the target machine, {user} for the user,
ssh     "ssh {user}@{host}"

# How to copy a file to a remote host from here.
# Use {src} for the source file, {host} for the target machine,
# {user} for the user, and {dst} for the target file.
scp     "scp {src} {user}@{host}:{dst}"

# install just lx on the local host
host localhost
    nodb

# install for the DB host blade124
host blade124
    # no monitoring system included, uncomment next line to include
    #stats

    # use this user on that host (defaults to $USER otherwise)
    user    leandata
    ssh     "ssh leandata@lsdclus04.ls.fi.upm.es -p 22124"
    scp     "scp -P 22124 {src} {user}@lsdclus04.ls.fi.upm.es:{dst}"
    # ssh/scp to be used within the installed hosts
    sshi    "ssh {user}@{host}"
    scpi    "scp {src} {user}@{host}:{dst}"

    # Single kvms
    kvms
        addr blade124!9999

    # 4 different kvds
    kvds x 4
        # put their disks at /ssd/xamplelx
        lxdir /ssd/xamplelx/ds
        # 30GiB for disk
        disk 30
        # 200MiB for mem
        mem 200

    # the lxmeta server
    lxmeta

    # a query engine
    lxqe

# make blade123 a mirror of blade124
host blade123
    mirror blade124