https://cdswiki.ligo-la.caltech.edu/foswiki/bin/view/CDS/DolphinHowTo
How to setup Gen-1 Dolphin Cards
- Install card in front end
- Check that card is available to FE machine, say c1sus2, using:
controls@c1sus2:~ 0$ lspci | grep Stargen 2a:00.0 Bridge: Stargen Inc. Device 0101 (rev 02) 2a:00.1 PCI bridge: Stargen Inc. Device 0102 (rev 02) ...
Make sure the IOP model - c1x07 in the case - has "pciRfm=1" in its cds parameter block, so that its dependence on dis_irm is evident as shown below:
controls@c1sus2:~ 0$ rtcds lsmod mbuf 16931 24 c1su2,c1hpc,c1bac,c1x07 symmetricom 12874 0 open_mx 79466 11 dis_kosif 51702 1 dis_dx dis_dx 131446 1 dis_irm dis_irm 382462 3 c1x07 c1x07 9352231 3 c1su2,c1hpc,c1bac ...
Log in to frame builder and edit '/etc/dis/disthosts.conf' following the pattern to add a new host, i.e. add lines for HOSTNAME, ADAPTER and SOCKET.
controls@fb1:~ 0$ tail -n21 /etc/dis/dishosts.conf HOSTNAME: c1sus ADAPTER: c1sus_a0 8 0 4 HOSTNAME: c1lsc ADAPTER: c1lsc_a0 12 0 4 HOSTNAME: c1ioo ADAPTER: c1ioo_a0 16 0 4 HOSTNAME: c1sus2 ADAPTER: c1sus2_a0 20 0 4 # Here we define a socket adapter in single mode. SOCKETADAPTER: sockad_0 SINGLE 0 # Finally, we define which IP interfaces will be enabled for SuperSockets # and which physical or virtual adapters will be used. # Keyword name/IP adapter name SOCKET: c1sus c1sus_a0 SOCKET: c1lsc c1lsc_a0 SOCKET: c1ioo c1ioo_a0 SOCKET: c1sus2 c1sus2_a0
- After update '/etc/dis/disthosts.conf', restart the netwirk manager service on framebuilder using:
controls@fb1:~ 0$ sudo systemctl restart dis_networkmgr
How to debug Dolphin Cards
- log on to fb with X forwarding:
ssh -X fb
- launch the Dolphin configuration/admin gui:
/opt/DIS/sbin/dxadmin
- Click connect. Wait a few moments (up to 30 seconds or so). This should bring up a display of the dolphin cards as well as the network router.