====== Installation ======

  * Log into the target machine
  * If an old kvqc2 exists stop the running kvqc2 process by 'kvstop -l' (lower case L), then type the number corresponding to kvqc2
  * Remove active configuration files (this is to just ensure that when the new kvqc2 version is set running it does not find and use an old configuration file)

For example:
<code>
$ cd /etc/kvalobs/Qc2Config
$ mv XXX.cfg XXX.hold 
$ mv ProcessUnit.cfg ProcessUnit.hold
</code>

Install the latest version of kvqc2

  * Log in as a user with sudoer permission
  * NB one may need to run "apt-get update" first in order to update the package list.
  * Run the following command:

<code>
$ sudo apt-get install kvqc2
</code>

The kvqc2 executable is placed in the standard location and the log and configuration files are managed as determined by the kvalobs package settings that can be checked with the "kvconfig" command use "kvconfig %%--%%help" for information, with kvalobs specific tuning set by [[https://svn.met.no/kvoss/kvalobs/trunk/src/lib/kvalobs/kvPath.h|kvPath]], i.e.:

<code>
 *  - prefix
 *  - pkglibdir     , eg $prefix/kvalobs              
 *  - sysconfdir    , eg $prefix/etc
 *  - libdir        , eg $prefix/lib
 *  - bindir        , eg $prefix/bin
 *  - datadir       , eg $prefix/share 
 *  - localstatedir , eg $prefix/var
 *  - logdir        , eg $localstatedir/log/kvalobs
 *  - rundir        , eg $localstatedir/run/kvalobs
</code>

^Description  ^ Location  ^
|Binary  | /usr/bin/kvqc2  |
|Log files, Qc2.log ... | /var/log/kvalobs/ |
|Algorithm configuration files *.cfg | /etc/kvalobs/Qc2Config |
|Generic configuration (kvalobs.conf) | /etc/kvalobs |

Check if a kvqc2 entry is included in the kv_ctl.conf (usually /etc(kvalobs/kv_ctl.conf), i.e. make sure kvqc2 is present (i.e. this is not included by default):

<code>
START_PROGS="kvQabased kvManagerd kvDataInputd kvServiced kvAgregated kvsynopd norcom2kv kvbufrd kvqc2"
STOP_PROGS="norcom2kv kvqc2 kvServiced kvDataInputd kvQabased kvManagerd kvAgregated kvbufrd kvsynopd "
TIMEOUT=60
KVUSER=kvalobs

</code>

====== "apt-get install" Example from dev-vm101 ======


For the kvqc2-1.0.2 revision:

<code>
xxx@dev-vm101:~$ sudo apt-get install kvqc2
Reading package lists... Done
Building dependency tree... Done
The following packages will be upgraded:
  kvqc2
1 upgraded, 0 newly installed, 0 to remove and 78 not upgraded.
Need to get 288kB of archives.
After unpacking 0B of additional disk space will be used.
Get:1 http://repo.met.no etch/main kvqc2 1.0.2-1 [288kB]
Fetched 288kB in 0s (12.7MB/s)
(Reading database ... 52403 files and directories currently installed.)
Preparing to replace kvqc2 1.0.1-1 (using .../kvqc2_1.0.2-1_i386.deb) ...
Unpacking replacement kvqc2 ...
Setting up kvqc2 (1.0.2-1) ...
xxx@dev-vm101:~$ 
</code>


====== Dependencies ======


QC2 utilises the same kvalobs libraries as QC1 (e.g. kvcpp and puTools). Other dependencies should be handled gracefully by aptititue (i.e. apt-get install etc...). 

**NOTE** //This has not yet been confirmed by trying to install Qc2 on an operational machine!!!
//

For reference other dependencies include:
  * netcdf
  * GNU Scientific Library
  * additional boost libraries

That can be added separately if //apt-get install// does not do this automatically:

<code>
$ apt-get install libgsl0-dbg libgsl0-dev libgsl0ldbl
$ apt-get install proj
$ apt-get install libnetcdf4
$ apt-get install libnetcdf-dev
$ apt-get install libboost-filesystem-dev
$ apt-get install boost-filesystem-dev
$ apt-get install libboost-filesystem-dev
$ apt-get install libboost-program-options
$ apt-get install libboost-programoptions
$ apt-get install libboost-program-options-dev
</code>