Skip to content

Latest commit

 

History

History
212 lines (156 loc) · 7.25 KB

Installation.md

File metadata and controls

212 lines (156 loc) · 7.25 KB
Raw

◀️ | ▶️

Demo System Installation

DemoSystem prerequisites

Operating system

DemoSystem can be run on Linux or Windows operating systems. The Windows support is experimental, tested on Windows 7.

Compatibility libraries

In case of 64 bit Linux operating system 32 bit compatibility libraries might need to be installed. For example:

  • lib32z1 on Ubuntu
  • zlib.i686 on Fedora

✅ Note:

Our test runs on 'fresh' installation of openSuse 12.3 worked without need for any additional packages

Kdb+ studio

Instructions in Lessons relay on checking data or status of KDB+ processes, therefore, IDE for kdb+ is required (e.g. http://code.kx.com/wiki/StudioForKdb+). Connection might need to be established from localhost (e.g. when both kdb+ studio and Enterprise Components are deployed locally) or over TCP (e.g. Enterprise Components on workstation, kdb+ studio on user’s desktop).

KDB+

DemoSystem has self-contained free 32 bit KDB+ v3.1 provided by Kx Systems. However, if needed:

  • most current version of KDB+ can be always downloaded from http://kx.com/software-download.php
  • KDB+ included in DemoSystem can be replaced by full (paid) version of 64 bit KDB+, in this case QHOME and PATH environmental variables have to be adjusted accordingly in env.sh (env.bat on Windows) file for each Lesson.

❗ Note:

Please note that we strongly advise to test DemoSystem first before making any changes.

DemoSystem installation

  1. Download and unpack package ec_vX.X.X_DemoSystem_Linux32bit_Lessons_X-X.tgz

    > tar zxvf ec_vX.X.X_DemoSystem_Linux32bit_Lessons_X-X.tgz

    On Windows download and unpack the package ec_vX.X.X_DemoSystem_Win32_Lessons_X-X.zip

    > unzip ec_vX.X.X_DemoSystem_Windows32bit_Lessons_X-X.zip

  2. Create link to configuration for LessonXX

    > cd DemoSystem
DemoSystem> ln -s bin/ec/tutorial/LessonXX/etc

    The corresponding commands for Windows are

    > cd DemoSystem
DemoSystem> mklink /J etc bin\ec\tutorial\Lesson01\etc

  3. Check if etc folder is linked to correct Lesson

    DemoSystem> ls -l etc
  etc -> bin/ec/tutorial/LessonXX/etc

    Use the dir command on Windows.

  4. After installation DemoSystem directory should contain bin directory and etc symbolic link

    DemoSystem> ls -l
  bin
  etc -> bin/ec/tutorial/LessonXX/etc/
  Installation.md
  README.md
  Troubleshooting_linux.md

Troubleshooting

Common installation problems with solutions for linux.

DemoSystem startup

  1. Source environment

    DemoSystem> source etc/env.sh

    On Windows one needs to run

    DemoSystem> etc\env.bat

  2. Start all components in the system (restart command is used just in case the system was already running)

    DemoSystem> yak restart \*
  Stopping components...
    core.gen                      	Skipped
    core.tick                     	Skipped
    core.rdb                      	Skipped
  Starting components...
    core.gen                      	OK
    core.tick                     	OK
    core.rdb                      	OK

  3. Check if all components are running

    DemoSystem> yak info \*
  uid                pid   port  status      started             stopped            
  ----------------------------------------------------------------------------------
  core.gen           11235 17009 RUNNING     2014.05.08 07:36:18                    
  core.rdb           11247 17011 RUNNING     2014.05.08 07:36:19                    
  core.tick          11241 17010 RUNNING     2014.05.08 07:36:18

  4. Check if data and log directories were created

    DemoSystem> ls -l
  bin
  data
  etc -> bin/ec/tutorial/LessonXX/etc/
  log
  readme.txt
  troubleshooting.txt

    On Windows, use the dir command.

Changing DemoSystem Lesson

Folder structure for data and log directories remains the same for all Lessons, therefore it is enough to change configuration pointer (symbolic link) to change the Lesson.

If you would like to start with fresh set of data and log directories - these can be removed while the system is stopped.

❗ Note:

Make sure that system is really stopped before deleting these directories, otherwise yak will lose its connection details resulting in error described in Issue 4.

  1. Stop the system

    DemoSystem> yak stop \*
  Stopping components...
    core.gen                      	OK
    core.tick                     	OK
    core.rdb                      	OK

  2. Remove link to configuration for LessonXX

    DemoSystem> ls -l etc
  etc -> bin/ec/tutorial/LessonXX/etc/
DemoSystem> rm etc

    On Windows, do

    DemoSystem> rmdir etc

  3. Create link to configuration for LessonYY

    DemoSystem> ln -s bin/ec/tutorial/LessonYY/etc
DemoSystem> ls -l etc
  etc -> bin/ec/tutorial/LessonYY/etc/

    On Windows:

    DemoSystem> mklink /J etc bin\ec\tutorial\LessonYY\etc

  4. Start the system again

    DemoSystem> yak start \*
  Starting components...
    core.gen                      	OK
    core.tick                     	OK
    core.rdb                      	OK

◀️ | ▶️