https://cdswiki.ligo-la.caltech.edu/foswiki/bin/view/CDS/DolphinHowTo

== How to setup Gen-1 Dolphin Cards ==

  1. Install card in front end

  1.#2 Check that card is available to FE machine, say c1sus2, using: 
  {{{#!highlight bash numbers=disable
  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)
  ...
  }}} 

  1.#3 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:
  {{{#!highlight bash numbers=disable
  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
  ...
  }}} 

  1.#4 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
}}} 

  1.#5 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 ==

  1. log on to fb with X forwarding:

ssh -X fb

  1.#2 launch the Dolphin configuration/admin gui:

/opt/DIS/sbin/dxadmin

  1.#3 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.