• KAGRA
• Subgroups
• DGS
• RTPC
• RCG3.1.1

Real-time Code Generator (RCG) version 3.1.1

• On this page, we prepared a procedure manual based on the experience of updating from version 2.9.7 to 3.1.1. Problems may occur even if updating is performed according to this procedure.

• The headings below are based on the LIGO document LIGO Document T1600055-v7. It has been modified accordingly for KAGRA system.

Preparation in advance

7.1.1 Install ldas-tools 2.4.2 for Gentoo DAQ

1. Log on as ‘controls’ to that NDS server (k1nds0)
2. Copy the downloaded file to /opt/rtapps/tarfiles
3. cd /opt/rtapps
4. tar –xzf tarfiles/ldas-tools-2.4.2-gentoo.tar.gz
5. unlink ldas-tools
6. unlink framecpp
7. ln –s ldas-tools-2.4.2 ldas-tools
8. ln –s ldas-tools-2.4.2 framecpp

Note : You can use "rm" instead of "unlink".

7.1.2 Update ldconfig on Gentoo DAQ computers

1. Login on to each Gentoo DAQ computer as ‘root’ (k1boot and k1nds0)
2. cd /etc/ld.so.conf.d
3. Edit framecpp-linux-x86_64 file to have the following

   /opt/rtapps/framecpp/lib

4. ldconfig (to update LD paths to point to new ldas-tools areas)

8.1 Install RCG 3.1.1 software for Gentoo

1. Log in as 'controls' to the boot server (k1boot)
2. cd /opt/rtcds/rtscore

3. svn co https://redoubt.ligo-wa.caltech.edu/svn/advLigoRTS/tags/advLigoRTS-3.1.1

4. rm release (break link to old Gentoo RCG)
5. ln -s advLigoRTS-3.1.1 release (set link to new Gentoo RCG)
6. Logout out of your session, and then log back in. This will make the new release the default version.

8.2.1 Set up new build area for front-ends

1. Login to the k1boot server as 'controls'
2. cd /opt/rtcds/kamioka/k1/rtbuild
3. mkdir rt-3.1.1 (or similar)
4. cd rt-3.1.1
5. /opt/rtcds/rtscore/release/configure - this will create Makefile, config.log, config.status files and doc,src folders
6. cd .. (this puts you back at /opt/rtcds/kamioka/k1/rtbuild)
7. unlink current (breaks link to old build area)
8. ln -s rt-3.1.1 current (set link to new build area)

8.2.2.1 Rebuild GDS libraries, awgtpman for front-ends

1. log in as 'controls' to the k1boot server
2. rcgcode (should take you to /opt/rtcds/rtscore/release)
3. cd src/gds
4. make clean
5. make
6. cp awgtpman /opt/rtcds/kamioka/k1/target/gds/bin/bin_archive/awgtpman.rcg-3.1.1 (copies in the new version)

8.2.2.2 Update mbuf driver

1. log in as 'controls' to the k1boot server
2. rcgcode (should take you to /opt/rtcds/rtscore/release)
3. cd src/drv/mbuf (to get to the mbuf directory)
4. make (to build new mbuf kernel object)
5. sudo make install
6. su root
7. cd /diskless/root/lib/modules/3.0.8/kernel/drivers/mbuf/
8. cp /lib/modules/3.0.8/extra/mbuf.ko mbuf.ko.3.1.1 (copies in the new version)

8.2.2.3 Update IRIG-B driver

Your existing IRIG-B driver is likely compatible, but to be safe with updated leap second list, lets update it.

1. log in as 'controls' to the k1boot server
2. rcgcode (should take you to /opt/rtcds/rtscore/release)
3. cd src/drv/symmetricom (to get to the symmetricom directory)
4. make (to build new symmetricom kernel object)
5. sudo make install
6. su root
7. cd /diskless/root/lib/modules/3.0.8/extra
8. cp /lib/modules/3.0.8/extra/symmetricom.ko symmetricom.ko.3.1.1 (copies in the new version)

8.2.2.4 Update mx_stream driver

1. log in as 'controls' to the boot server
2. rcgcode
3. cd src/mx_stream
4. make clean
5. make
6. cp mx_stream /opt/rtcds/kamioka/k1/target/fb/bin_archive/mx_stream.rcg-3.1.1 (copies in the new version)

8.3.1.2 Rebuild GDS libraries for Gentoo DAQ

1. log in as 'controls' on an NDS server (i.e. k1nds0)
2. rcgcode (should take you to /opt/rtcds/rtscore/release, which should be RCG 3.1.1 checout)
3. cd src/gds
4. make clean
5. make

Set environment variable

1. Download /opt/cdscfg/rtsetup.sh from LIGO subversion
2. source /opt/cdscfg/rtsetup.sh

8.3.1.3 Configure Gentoo daqd, nds build areas

1. log in as 'controls' on an NDS server (i.e. k1nds0)
2. rcgcode (should take you to /opt/rtcds/rtscore/release, which should be RCG 3.1.1 checout)
3. cd src/daqd
4. ./bootstrap
5. cd ../nds
6. ./bootstrap
7. cd ../..

8.3.1.4 Set up new build area for Gentoo DAQ

1. log in as 'controls' on an NDS server (i.e. k1nds0)
2. cd /opt/rtcds/kamioka/k1/daqbuild
3. mkdir daq-3.1.1 (or similar)
4. cd daq-3.1.1
5. ${RCG_DIR}/configure - this will create Makefile, config.log, config.status files and doc,src folders
6. cd .. (this puts you back at /opt/rtcds/kamioka/k1/daqbuild)
7. unlink current (breaks link to old build area)
8. ln -s daq-3.1.1 current (set link to new build area)

8.3.1.5 Build the Gentoo data receiver executable (daqd) for trend-writer

1. log in as 'controls' on NDS server (i.e. k1nds0)
2. daqcode
3. make fw
4. cd build/fw
5. cp -p daqd /opt/rtcds/kamioka/k1/target/k1daqtw0/bin_archive/daqd.rcg-3.1.1 (copies in the new version)
6. cp -p daqd /opt/rtcds/kamioka/k1/target/k1daqtw1/bin_archive/daqd.rcg-3.1,1 (copies in the new version)
7. cp -p daqd /opt/rtcds/kamioka/k1/target/k1daqfw0/bin_archive/daqd.rcg-3.1.1 (copies in the new version)
8. cp -p daqd /opt/rtcds/kamioka/k1/target/k1daqfw1/bin_archive/daqd.rcg-3.1,1 (copies in the new version)

8.3.1.6 Build the Gentoo data receiver executable (daqd) for NDS servers

1. log in as 'controls' on NDS server (i.e. k1nds0)
2. daqcode
3. make rcv
4. cd build/rcv
5. cp -p daqd /opt/rtcds/kamioka/k1/target/k1daqnds0/bin_archive/daqd.rcg-3.1.1 (copies in the new version)
6. cp -p daqd /opt/rtcds/kamioka/k1/target/k1daqnds1/bin_archive/daqd.rcg-3.1.1 (copies in the new version)

8.3.1.7 Build the Gentoo NDS executable (nds) for NDS

1. log in as 'controls' on NDS server (i.e. k1nds0)
2. daqcode
3. make nds
4. cd build/nds
5. cp -p nds /opt/rtcds/kamioka/k1/target/k1daqnds0/bin_archive/nds.rcg-3.1.1 (copies in the new version)
6. cp -p nds /opt/rtcds/kamioka/k1/target/k1daqnds1/bin_archive/nds.rcg-3.1.1 (copies in the new version)

8.3.1.8 Build the Gentoo GDS broadcaster executable (daqd)

1. log in as 'controls' on NDS server (i.e. k1nds0)
2. daqcode
3. make bcst
4. cd build/bcst
5. cp -p daqd /opt/rtcds/kamioka/k1/target/k1daqbcst0/bin_archive/daqd.rcg-3.1.1 (copies in the new version)

8.3.1.13 Build Gentoo data concentrator executable

1. log in as 'controls' to NDS server used for builds (i.e. k1daqnds0)

2. daqcode (Using an alias to get to /opt/rtcds/<site>/<ifo>/daqbuild/current)

3. make dc
4. cp -p build/dc/daqd /opt/rtcds/kamioka/k1/target/k1daqdc0/bin_archive/daqd.rcg-3.1.1 (copies in the new version)

Update

7.1.1 Install ldas-tools 2.4.2 for Gentoo DAQ

1. Log on as ‘controls’ to that NDS server
2. cd /opt/rtapps
3. unlink ldas-tools
4. unlink framecpp
5. ln –s ldas-tools-2.4.2 ldas-tools
6. ln –s ldas-tools-2.4.2 framecpp

7.1.2 Update ldconfig on Gentoo DAQ computers

1. Login on to each Gentoo DAQ computer as ‘root’ (k1boot, k1dc0, k1bcst0, k1nds0, k1nds1, k1fw0, k1fw1, k1tw0, k1tw1)
2. cd /etc/ld.so.conf.d
3. Edit framecpp-linux-x86_64 file to have the following

   /opt/rtapps/framecpp/lib

4. ldconfig (to update LD paths to point to new ldas-tools areas)

8.1 Install RCG 3.0 software for Gentoo

8.2.1 Set up new build area for front-ends

1. Login to the k1boot server as 'controls'
2. cd /opt/rtcds/kamioka/k1/rtbuild
3. unlink current (breaks link to old build area)
4. ln -s rt-3.1.1 current (set link to new build area)

8.2.2.1 Rebuild GDS libraries, awgtpman for front-ends

1. log in as 'controls' to the k1boot server
2. target
3. cd gds/bin
4. ln -s bin_archive/awgtpman.rcg-3.0 awgtpman (set link to new one)

8.2.2.2 Update mbuf driver

1. log in as 'controls' to the k1boot server
2. su root
3. cd /diskless/root/lib/modules/3.0.8/kernel/drivers/mbuf/
4. unlink mbuf.ko
5. ln -s mbuf.ko.3.1.1 mbuf.ko (makes the new version the active one)

8.2.2.3 Update IRIG-B driver

1. log in as 'controls' to the k1boot server
2. cd /diskless/root/lib/modules/3.0.8/extra
3. unlink symmetricom.ko
4. ln -s symmetricom.ko.3.1.1 symmetricom.ko (makes the new version the active one)

8.2.2.4 Update mx_stream driver

1. log in as 'controls' to the k1boot server
2. target
3. cd fb
4. unlink mx_stream
5. ln -s bin_archive/mx_stream.rcg-3.1.1 mx_stream (to install the new one)

8.2.2.5 Update mx_stream driver script

1. Login to k1boot server as 'root'
2. cd /diskless/root/etc/init.d
3. Edit the mx_stream file so the mx_stream command line has an added ‘–e 0’ on it. For example:

   start-stop-daemon --start --quiet -b -m --pidfile /var/log/mx_stream.pid --exec /opt/rtcds/kamioka/k1/target/fb/mx_stream -- -e 0 -s "$sys" -d k1dc0:0 -w 0 -W 0 -l /opt/rtcds/kamioka/k1/target/fb/mx_stream_logs/$hostname.log

8.2.2.6 Update script

1. Login to k1boot server as 'controls'
2. cd /opt/rtcds/kamioka/k1/scripts
3. ln -s /opt/rtcds/rtscore/release/src/epics/util/iniChk.pl iniChk.pl
4. ln -s /opt/rtcds/rtscore/release/src/epics/util/fe_load_burt fe_load_burt
5. ln -s /opt/rtcds/rtscore/release/src/epics/util/grdfiltdecode.py grdfiltdecode.py

8.2.3.1 Clear out old IPC tables

1. Log into k1boot server as ‘controls’
2. cd /opt/rtcds/kamioka/k1/chans/ipc

3. mv K1.ipc K1_<date>.ipc

4. touch K1.ipc

8.2.3.2 Create new 'tmp' folder for filters

1. Log into k1boot server as ‘controls’
2. cd /opt/rtcds/kamioka/k1/chans
3. mkdir tmp

8.2.3.3 Rebuild all models

1. Log into each RT servers (i.e. k1ioo0)
2. Use ‘cdscode’ to move to build area
3. make -i World (run make ignoring errors)
4. Check for errors in *_error.log files (grep ERROR *_error.log). Correct issues with ungrounded filter inputs, etc. in models
5. cdscode
6. make World

Note:If you get any error, rebuild models on another RT server and try rebuild again. Note:Change the number of "digital IO" to 24

8.2.3.4 Install all new models

1. cd to build area.
2. make installWorld

8.2.4 Restart all front-ends

8.3.1.9 Stop daqs on trend-writer, install new daqd executable, restart

1. log in as 'controls' to trend writer (k1daqfw0, k1daqfw1, k1daqtw0, k1daqtw1)
2. sudo /etc/init.d/monit stop
3. target
4. cd k1daqtw0
5. unlink daqd
6. ln -s bin_archive/daqd.rcg-3.1.1 daqd
7. sudo /etc/init.d/monit start

8.3.1.10 Install, run new daqd, nds executables on NDS server

1. log in as 'controls' to NDS server (i.e. k1nds0)
2. sudo /etc/init.d/monit stop
3. target
4. cd k1daqnds0
5. unlink daqd
6. ln -s bin_archive/daqd.rcg-3.1.1 daqd
7. unlink nds
8. ln -s bin_archive/nds.rcg-3.1.1 nds
9. sudo /etc/init.d/monit start

8.3.1.11 Install, run new daqd, nds executables on GDS broadcaster

1. log in as 'controls' to GDS broadcaster (i.e. k1bcst0)
2. sudo /etc/init.d/monit stop
3. target
4. cd k1daqbcst0
5. unlink daqd
6. ln -s bin_archive/daqd.rcg-3.1.1 daqd
7. sudo /etc/init.d/monit start

8.3.1.12 Stop DAQ on data concentrator for IRIG-B driver update

1. log in as 'controls' to data concentrator (i.e. k1dc0)
2. sudo /etc/init.d/monit stop (stop the monit process to keep from restarting daqd, nds)

8.3.1.14 Update IRIG-B driver on data concentrator

1. log in as 'controls' to data concentrator (i.e. k1dc0)
2. rcgcode (should take you to /opt/rtcds/rtscore/release)
3. cd src/drv/symmetricom (to get to the symmetricom directory)
4. make (to build new symmetricom kernel object)
5. sudo make install

8.3.1.15 Start daqd on Gentoo data concentrator

1. log in as 'controls' to data concentrator (i.e. k1dc0)
2. target
3. cd k1daqdc0
4. unlink daqd
5. ln -s bin_archive/daqd.rcg-3.1.1 daqd (to install new one as active copy)
6. sudo /etc/init.d/monit start

Troubles

• klog7347

• klog7349

• klog7351

• DGS Blog