Software installation
=====================

Not written yet.

.. This section describes how to install the HiPERCAM software running on the
.. rack and data reduction PCs.

.. To install software from scratch on the rack PC:

.. Technique 1: use a clone disk
.. -----------------------------
.. Give details here.

.. Technique 2: update from github
.. -------------------------------

.. - First, install the ESO NGC software:
..   cd /home/insuser/
..   git clone  git@github.com:HiPERCAM/hiperCamCCD.git
..   Then, in /home/insuser still, type: irRebuildCCD.sh
..   This rebuilds the NGC software.

..   Note:
..   - irRebuildCCD.sh (and irRebuild.sh below) can be run from *any* directory
..   (you don't first need to cd into hiperCamCCD, for example)
..   - Stu emailed me notes on how to update when you don't git clone but instead
..     git pull (which is what you want to do when the repository is already set
..     up and you just want to update the software). So copy these instructions
..     in here. For git pull, you *do* have to be in the correct repository
..     directory though (e.g. hiperCamCCD)
  
.. - Second, install the ESO NGC configuration files:
..   cd /home/insuser
..   git clone  git@github.com:HiPERCAM/hipercamcfg.git
..   Then, in /home/insuser still, type: irRebuild.sh (NB: not CCD!)
..   This installs the NGC config files into their proper location.
  
.. - Third, install the python software (hdriver). Two steps to this:
..   cd /home/insuser
..   git clone  git@github.com:HiPERCAM/hcam_widgets.git
..   cd hcam_widgets
..   sudo pip install -U --no-deps . (password pass123)

..   cd /home/insuser
..   git clone  git@github.com:HiPERCAM/hcam-drivers.git
..   cd hcam-drivers
..   sudo pip install -U --no-deps . (password pass123)

..   Try typing hdriver. It might not yet work due to missing python
..   modules. To install these:
..   sudo pip install requests (password pass123)

..   Need to install omniORB and omniORBpy to get GTC comms working.
..   - Go to url http://omniorb.sourceforge.net
..     Click on omniORB_4.2.2 and download omniORB-4.2.2.tar.bz2
..     AND
..     Click on omniORBpy_4.2.2 and download omniORBpy-4.2.2.tar.bz2
..     Then:
..     bunzip2 omniORB-4.2.2.tar.bz2 (in /home/insuser/Downloads directory)
..     tar xvf omniORB-4.2.2.tar
..     cd omniORB-4.2.2
..     mkdir build
..     cd build
..     ../configure --prefix=/usr/local/omniORB-4.2.2
..     make
..     sudo make install
    
..     cd omniORBpy-4.2.2
..     mkdir build
..     cd build
..     ../configure --prefix=/usr/local/omniORBpy-4.2.2 --with-omniorb=/usr/local/omniORB-4.2.2
..     make
..     sudo make install
    
..     And add the following lines to /etc/pecs/etc/generic_profile
..     export PYTHONPATH=/usr/local/omniORBpy-4.2.2/lib/python2.7/site-packages:/usr/local/omniORBpy-4.2.2/lib64/python2.7/site-packages
..     export LD_LIBRARY_PATH=/usr/local/omniORB-4.2.2/lib:$LD_LIBRARY_PATH

..     Then to test, this should run without errors:
..     python> import CosNaming

..     There are also some interface definition files (idl's) to install
..     (need to copy from GTC). Put them in a directory under
..     /usr/local/corba_idls and then add this to the PYTHONPATH using
..     the same recipe as above: export
..     PYTHONPATH=/usr/local/omniORBpy-4.2.2/lib/python2.7/site-packages:/usr/local/omniORBpy-4.2.2/lib64/python2.7/site-packages:/usr/local/corba_idls
..     (THIS STILL NEEDS TO BE DONE ON THE RACK PC IN THE LAB)

..     Now take data to test all is ok!