######################################
Fine-tune a Qserv development instance
######################################


Pre-requisites
==============

First, download `qserv-operator` locally

.. code:: bash
   
   git clone https://github.com/lsst/qserv-operator

Core path
=========

It is possible to set the core path easily by editing the `corepath` parameter in file `qserv-operator/overlays/dev/qserv.yaml`

.. code:: yaml

   apiVersion: qserv.lsst.org/v1alpha1
   kind: Qserv
   metadata:
   name: qserv
   spec:
   devel:
      corepath: "<core-path>"


Manual debugging with gdb
=========================

It is possible to set the component to debug by editing the `debug` parameters in file `qserv-operator/overlays/dev/qserv.yaml`

.. code:: yaml

   apiVersion: qserv.lsst.org/v1alpha1
   kind: Qserv
   metadata:
   name: qserv
   spec:
   ...
   replication:
     debug: "repl-ctl"

In above example, replication controller will not start, so that user can open an interactive shell inside the container,
start the replication controller process and perform debugging operation. The container won't restart if the replication controller crashes.


Re-install Qserv
================

Once file `qserv-operator/overlays/dev/qserv.yaml` is ready, (re-)install Qserv in the current namespace

.. code:: bash
   
   kubectl apply -k qserv-operator/overlays/dev