• Available Platforms
• Compiling
• Installing Device Drivers
• Setting Environmental Variables

Basic System

Optional Software

GTK+ library (2.4 or later) [Strongly Recommended]: http://www.gtk.org/

libxml library [Strongly Recommended]: http://xmlsoft.org/

For KiNOKO's GUI interface.

Perl [Strongly Recommended]: http:www.perl.com/CPAN/

To make several utilities attached to KiNOKO available.

zlib library [Recommended]: http://www.gzip.org/zlib/

For data compression functions.

This library needs to be linked in order to read compressed data as well.

GNU/readline library [Recommended]: http://www.gnu.org/directory/readline.html

Makes command lines easier. Curses or ncurses library must be installed to use this (installed with normal setup).

ROOT [Recommended]: http://root.cern.ch/

Users will be able to display histograms, etc using scripts Kinoko automatically generates.

Users will be able to save histograms etc generated by Kinoko online in ROOT format.

The interpreter version of KinokoScript will be able to read and write ROOT files.

SQL Data Bases

Users will be able to access a database in many situations. The following list contains database systems that are supported by Kinoko as of April '03.

• PostgreSQL (7.1.3 or later): http://www.postgresql.org/
• MySQL (3.23 or later): http://www.mysql.com/
• SQLite (2.7.2 or later): http://www.hwaci.com/sw/sqlite/

XSLT Processors

Files such as HTML files can be automatically generated from Run Summary files that Kinoko generates in XML format. The following are some of the XSLT processors that are available for free.

• libxslt (Gnome): http://xmlsoft.org/XSLT/
• Xalan (Apache): http://xml.apache.org/

1. Unpack the package at the directory you want to install kinoko.

     % cd the directory you want to install kinoko
     % gunzip kinoko.tar.tz
     % tar xvf kinoko.tar
   

   A new directory kinoko will be created.

2. 'configure' the source codes to make them fit to your platform.

     % cd kinoko/src
     % ./configure-for LINUX
   

   'configure-for' is a shell script that executes configure with sets parameters, such as compiler options, according to its argument prior to executing the script.

   The current configuration option definitions are the following:

   Name	Compiler	Compiler Option	Libraries
   LINUX	g++	-Wall	GTK, SQLDB, ROOT, ...
   LINUX-MIN	g++	None	GTK
   OSX	g++	-m32 -Wall	GTK-OSX, ROOT
   AIX	xlC	-Wl,-bbigtoc	None
   AIX64	xlC	-Wl,-bbigtoc	None
   AIX-GCC	g++	None	None
   CCNET	g++	None	camlib for CCNET

   Optional second arguments can be passed to the compiler as well like the following.

   % ./configure-for LINUX "-g -O2"
   

   Instead of using configure-for, you can manually set parameters and use configure directly. (The following is a csh/tcsh example)

   % setenv CXX "g++"           
   % setenv CPPFLAGS ""
   % setenv CXXFLAGS "-Wall -g"
   % setenv MAKE "gmake"
   % ./configure --without-readline --with-PostgreSQL
   

   ^*The first line will become export CXX="g++" in a BASH shell.

3. Compile the code. It will take 10 to 15 minutes on a PentiumIII PC.

   % make
   

   If compilation is successful, the following line will be displayed.

   Make: successful
   

To use the CC/7x00 CAMAC controller (Toyo) or the CCP-PCI CAMAC controller (Hoshin) on Linux:

Install the 'camdrv' driver, which comes with the Kinoko package. The driver source is in the 'kinoko/drv/camdrv' directory. Refer to the camdrv home page to get the installation instructions.

The simplified steps to install are shown here. You must remember that proper settings such as jumper settings on the device itself are required too.

% cd kinoko/drv/camdrv/LinuxVerstion-devicename
% make
% su
# make install
# exit

To use Model-617/618/620 VME controller (SBS Technologies, or Bit3) on Linux:

Install the 'vmedrv' driver, which comes with the Kinoko package. The driver source is in the 'kinoko/drv/vmedrv' directory. Refer to the vmedrv home page to get the installation instructions.

The simplified steps to install are shown here. You must remember that proper settings such as jumper settings on the device itself are required too.

% cd kinoko/drv/camdrv/LinuxVerstion-devicename
% make
% su
# make install
# exit

When you compile Kinoko, the files kinoko-cshrc and kinoko-bashrc are created in kinoko/src. Add these to .cshrc(or.tcshrc) or .bashrc in your home directory.

If you are using 'tcsh':

% cat kinoko-cshrc >> $HOME/.cshrc

If you are using 'bash':

$ cat kinoko-bashrc >> $HOME/.bashrc

The following is an example of kinoko-cshrc generated by this process.

### Kinoko Settings ### setenv KINOKO_ROOT /usr/local/kinoko setenv KINOKO_XTERM /usr/X11R6/bin/kterm setenv KINOKO_RSH /usr/bin/ssh setenv KINOKO_CONTROL_PORT_BASE 40000 setenv KINOKO_DATASTREAM_PORT_BASE 42000 setenv KINOKO_SHELL_PORT_BASE 45000 setenv KCOM_PATH ".:${KINOKO_ROOT}/bin" setenv PATH "${PATH}:${KINOKO_ROOT}/bin"

---

Edited by: Enomoto Sanshiro