How to start a brand new RTS model

(reference: aLIGO wiki, "how to add a brand-new front-end model")

1. Determine what's already in use
   • Run lsmod on the [front-end,host] computer to determine what models are running
   • Look at the model names running and go look at the corresponding simulink models and look at the parameters block (cpu, dcuid number, etc).
   • Check what CPUs are available, the ones actually displayed when you run 'cat /proc/cpuinfo' on the [front-end,host] computer. Note always leave a CPU (usually 0) free for the OS. CPU 1 is for the IOP.
2. Create the new model
   • Fill in the cdsParameters block appropriately.
   • Rates are 2K, 4K, 16K, 32K, 64K
   • Two filter minimum in the model or else doesn't run. 1 ADC minimum. Get parts from CDS_PARTS.mdl
3. Go to the build computer usually k1boot (will be changed in the future) and build the model
   • Go to the build directory (cd /opt/rtcds/rtscore/release/)
   • make clean-MODELNAME
   • make MODELNAME
   • make install-MODELNAME
   • Be aware if you are using IPC (dolhpin,RFM, shared memory), build the sender first. If you have senders sending to each other, build one, then the other, then build the first again.
4. Add the model to the rtsystab and edit master file
   • Login to k1boot and modify the rtsystab (sudo emacs /diskless/root/etc/rtsystab)
   • Add model name to the right of the computer name (example: computername MODELNAME MODELNAME)
   • Add the model's channel and tp files to the framebuilder master file (usually located something like /opt/rtcds/kamioka/k1/target/fb/master
     • Only attempt this with the assistance of the cds admin or equivalent*
   • Check if the .ini files (i.e. the files in /opt/rtcds/kamioka/k1/chans/daq/, such as K1EDCU_MODELNAME.ini and MODELNAME.ini) are added under the appropriate IOP file.
   • Check if the .par files (i.e. the tpch_MODELNAME.par file which lives in /opt/rtcds/kamioka/k1/target/gds/param/) are added, also under the appropriate IOP file.
   • Restart the frame builder process so the channels get recorded
     • Only attempt this with the assistance of the cds admin or equivalent*
5. Reboot k1lsc (computername)
   • sudo reboot
6. Start the model on the front end computer for the first time
   • Have the GDS_TP screen up first (usually located in /opt/rtcds/kamioka/k1/medm/MODELNAME/MODELNAME_GDS_TP.adl)
   • startMODELNAME (located in i.e. /opt/rtcds/kamioka/k1/scripts/)
   • Hit the BURT button soon after the EPICS come up (you usually have 5-10 seconds), so the front end code will think a burt restore has been done and actually start - this procedure is changed after RTS2.9.
   • Update the appropriate MEDM screens via the MEDM update screen from the sitemap (under the 'MEDM' button).
   • Setup your safe.snap (a burt snapshot of a safe state) so you don't need hit BURT each time (generally soft-linked from userapps to target/MODELNAME/MODELNAMEepics/burt/safe.snap file) example: login as controls in a terminal, then enter: makeBackup vis MODELNAME