Installing BLU-ICE

1. Install the SSRL libraries.
   • Install the xos library .

   • Install the auth library .

   • Install the jpegsoc library.

   • Install the tcl_clibs .

   • Install the widgets library .

     This step also requires that the environment variables for your Unix session be set correctly:

     setenv TCLLIBPATH "/usr/local/dcs/widgets"

2. Install all of the required third party packages and libraries.
   • Verify that you have a recent version of TCL installed on your computer.

     tclsh
     % info tclversion
     8.3
     % exit
     

   • Verify that the third party library Itcl is installed correctly on your computer.

      bl92a:~ > wish 
     % package require Itcl
     3.2
     % exit
     

   • Verify that the third party TCL library BWidget is installed correctly on your computer.

     bl92a:~ > wish
     % package require BWidget
     1.2.1
     % exit
     bl92a:~ >
     

   • Verify that the third party TCL library BLT is installed correctly on your computer.

     bl92a:~ > wish
     % package require BLT
     2.4
     % exit
     bl92a:~ >
     

   • Verify that the third party TCL library Img is installed correctly on your computer.

     bl92a:~ > wish
     % package require Img
     1.2.4
     % exit
     bl92a:~ >
     

3. Checkout the BLU-ICE project from CVS in to the /usr/local/dcs directory.

   cvs checkout blu-ice
   cvs checkout: Updating blu-ice
   cvs checkout: Updating blu-ice/data
   U blu-ice/data/calibration_edges.dat
   U blu-ice/data/periodic_bl11.dat
   U blu-ice/data/periodic_bl15.dat
   U blu-ice/data/periodic_bl91.dat
   U blu-ice/data/periodic_bl92.dat
   cvs checkout: Updating blu-ice/images
   U blu-ice/images/beamstop.gif
   U blu-ice/images/frontend.gif
   U blu-ice/images/frontend_small.gif
   U blu-ice/images/gonio.gif
   U blu-ice/images/mar_small.gif
   U blu-ice/images/q4_small.gif
   U blu-ice/images/splash.gif
   U blu-ice/images/splash.jpg
   cvs checkout: Updating blu-ice/irix
   U blu-ice/irix/ice
   U blu-ice/irix/makefile
   cvs checkout: Updating blu-ice/scripts
   U blu-ice/scripts/Diffimage.tcl
   U blu-ice/scripts/SafeEntry.tcl
   U blu-ice/scripts/beamline_gui.tcl
   U blu-ice/scripts/bl11_specific.tcl
   U blu-ice/scripts/bl71_specific.tcl
   U blu-ice/scripts/bl91_specific.tcl
   U blu-ice/scripts/bl92_specific.tcl
   U blu-ice/scripts/bl92sim_specific.tcl
   U blu-ice/scripts/blcommon.tcl
   U blu-ice/scripts/centering.tcl
   U blu-ice/scripts/classify_field.tcl
   U blu-ice/scripts/configure_motor.tcl
   U blu-ice/scripts/cursors.tcl
   U blu-ice/scripts/default_rc.tcl
   U blu-ice/scripts/define_scan.tcl
   U blu-ice/scripts/dice_tabs.tcl
   U blu-ice/scripts/filters.tcl
   U blu-ice/scripts/genkey.sh
   U blu-ice/scripts/hardware_commands.tcl
   U blu-ice/scripts/hutch.tcl
   U blu-ice/scripts/hutch_setup.tcl
   U blu-ice/scripts/ice.tcl
   U blu-ice/scripts/mdw_document.tcl
   U blu-ice/scripts/mega_widget.tcl
   U blu-ice/scripts/message_handlers.tcl
   U blu-ice/scripts/motor_control.tcl
   U blu-ice/scripts/plot.tcl
   U blu-ice/scripts/reswidget.tcl
   U blu-ice/scripts/scan.tcl
   U blu-ice/scripts/scanlog.tcl
   U blu-ice/scripts/set.tcl
   U blu-ice/scripts/splash.tcl
   U blu-ice/scripts/traces.tcl
   U blu-ice/scripts/typed_command.tcl
   U blu-ice/scripts/user_scan.tcl
   U blu-ice/scripts/util.tcl
   U blu-ice/scripts/wedge.tcl
   cvs checkout: Updating blu-ice/src
   

4. Modify ice.tcl to connect to your DCSS server.

   Within ice.tcl there is a large switch statement which sets up the BLU-ICE for a particular beam-line. This will need to be modified in some way to reflect your beam line configuration.

5. Modify the file dice_tabs.tcl and change the following line to reflect a connection to your own diffraction image viewer (not smbfs).

   Diffimage lastImage $gWindows(collect,diffimage,frame) smbfs 14443 500 500

   If you do not have the diffraction image viewer set up, then this can be commented out. You may need to search for the lastImage object and comment out references to this object as well.

6. Start BLU-ICE with the name of the beam line that you wish to connect to.

   /usr/local/dcs/blu-ice/scripts/ice.tcl bl92

   The bl92 in the above example should be reflected within the switch statement within ice.tcl so that the program knows which beam line to connect to.