Setting up the server
*********************

Create the directory structure where the fplaneserver should be running
e.g. fplaneserver

::

    > mkdir fplaneserver
    > cd fplaneserver

Within this directory create the subdirectory structure for fplaneserver

::

    > mkdir {data,logs,spool}


In the work directory create a configuration file e.g. ``fplaneserver.conf``
overwriting the relevant configuration variables (See :ref:`confvars`
for details). Copy an existing ``users.db`` from another fplaneserver instance
or add new users using the :ref:`adduser` tool. Use the
:ref:`make_ds_struct` tool to create the hash based directory
structure in the `data` directory.


Starting up the FPlaneServer Server
-----------------------------------

To start the fplaneserver server change into its run directory and start it
with::

     FPS_SETTINGS=$PWD/server.conf gunicorn -w 2 --threads 4 -D -b euclid04.opt.rzg.mpg.de:9100 fplaneserver:app --access-logfile access.log

In this example for a fplaneserver running on port 9100 on euclid04.opt.rzg.mpg.de


Running in HTTPS mode
---------------------

To run it in HTTPS mode, create a certificate / key pair (e.g. fplaneserver.crt
and fplaneserver.key) and start it:

::

    gunicorn -b euclid04.opt.rzg.mpg.de:9100 fplaneserver:app \
    --access-logfile access.log \
    --cert-file fplaneserver.crt --keyfile fplaneserver.key