Differences

This shows you the differences between two versions of the page.

--- kvalobs:kvoss:system:qc2:user:installation [2009-12-19 22:54:20]
paule
+++ kvalobs:kvoss:system:qc2:user:installation [2022-05-31 09:29:32] (current)
@@ Line 1: / Line 1: @@
 ====== Installation ======
-FIXME
+  * 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)
-Qc2 will build as part of the normal kvoss distribution. However, this is currently turned off in the kvoss trunk.
+For example:
+<code>
+$ cd /etc/kvalobs/Qc2Config
+$ mv XXX.cfg XXX.hold
+$ mv ProcessUnit.cfg ProcessUnit.hold
+</code>
-Minor chaanges need to be made to
+Install the latest version of kvqc2
-The branch: https://svn.met.no/viewvc/kvoss/kvalobs/branches/kvalobs-Qc2build-20090719/ illustrates the changes that have to be made to //confugure.ac//
-<code>src/kvQc2/Makefile </code>
-and the src/Makefile.am
-<code>kvQc2 \ </code>
-to build kvQc2. It is not recommended to build from the branch since this is an old snapshot. For now it is just an illustration of the configure and Makefile changes. Build from the trunk!
-Even then, there are surprises in store when building kvQc2:
+  * Log in as a user with sudoer permission
-  * requires netcdf
+  * NB one may need to run "apt-get update" first in order to update the package list.
-  * requires the GNU Scientific Library
+  * Run the following command:
-  * utilises a number of other boost libraries (ITEMIZE) **TBD**
+<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.:
-.... more will appear here in time ...
+<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
+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>