Nanospectroscopy beamline - installing and compiling UMeasure

You can download the software package from:
"\\sincro-share\private\nanospectroscopy"; Use your username (name.surname@elettra.trieste.it) and password, mapping it as a network drive on your computer. You may have to reboot your computer before this can work.
Alternatively, another copy can be found on:
"\\sincro-share\public\nanospectroscopy\GUI".
This copy does not require username and password, and is frequently updated.

Umeasure needs Jython. Please copy jython.zip and extract it into: C:\jython
Get Umeasure and copy (or extract it) to "C:\GUI".
A "build" utility called Apache ant is used to compile Umeasure into a single jar file, and organise the source files and the various classes into subfolders.
- Get apache-ant-1.5.3-1.zip. Extract the apache ant zip file into a dedicated directory. We suggest to unzip to:
  C:\ant\apache-ant-1.5.3-1
- More recent versions of ant are found on the ant website
Install Java SDK SE on your computer, which you can download from the java website. We strongly advice to choose the following installation path for SDK, for example: C:\javasoft\jdk16010. In order to do this on the beamline computers, you need to have administration privileges. At the time of writing, "UMeasure" was compiled successfully using JAVA SDK 1.6.010.
Install the RXTX communication package (verision 2.1.8) on the computer:
- copy RXTXcomm.jar to the JRE and JDK directories, e.g.:
  - C:\program files\java\jre6\lib\ext\RXTXcomm.jar
  - C:\javasoft\jdk16010\jre\lib\ext\RXTXcomm.jar
- copy rxtxserial.dll to the JRE and JDK directories, e.g.:
  - C:\program files\java\jre6\bin\rxtxserial.dll
  - C:\javasoft\jdk16010\bin\rxtxserial.dll
  - C:\javasoft\jdk16010\jre\bin\rxtxserial.dll

CONFIGURE THE COMPUTER - Update the path and the environment variables

Update the Windows path, so that ant can be invoked from the command prompt. For example, add the following line to the Windows path variable:
" ...;C:\ant\apache-ant-1.5.3-1\bin; ...".
Update the Windows path, so that javac can be invoked from the command prompt. For example, add the following line to the Windows path variable:
" ...;C:\javasoft\jdk16010\bin; ...".
In your Windows environment variables, create a variable "ANT_HOME" and set it to the desired "ant" home directory, e.g. "C:\ant\apache-ant-1.5.3-1".
In your Windows environment variables, create (or update) the variable "CLASSPATH"; In order to do this, copy paste into the CLASSPATH variable the text written here (the same text file can be found also in the GUI main directory).
In your Windows environment variable, create a variable "JAVA_HOME" and set it to the compiler directory, e.g. "C:\javasoft\jdk16010". This is needed to tell ant which java compiler to use.
Initialise ant. Open a dos window, and the command prompt just type "ant".

CONFIGURE THE NAMESERVER

If want to re-install Umeasure on "pnano5", you do not need to change configuration files. Please check that the batch file gui.bat is correctly configured, i.e. the variable "NAMESERVICE" is set to: "NameService=corbaloc::pnano5:2500/NameService ".

If the nameserver runs from a different computer, change the NAMESERVICE value accordingly, by replacing the string "pnano5" with the name of the host computer.

If you wish to have the nameserver running on a different computer than pnano5, you have to do the following:

Go to the "C:\GUI\nameserver" direcotory and delete the omninames log and bak files: "omninames-COMPUTERNAME.bak" and "omninames-COMPUTERNAME.log".
Reset omnninames! In order to do this, you need to open a command window, and change the path to:
c:\GUI\NameServer\bin\x86_win32
then type the command:
omniNames -start PORTNUMBER -logdir c:\GUI\NameServer
from now on, it will be possible to start the nameserver using the following commandline:
c:\GUI\NameServer\bin\x86_win32\omniNames.exe -logdir c:\GUI\NameServer
which can be found in the GUI main directory in the "nameserver.bat" file. Then edit all batchfiles, i.e. beamlineserver.bat, ccdserver.bat etc., and check out that the COMPUTER NAME and the PORTNUMBER are correctly set.
Change the CORBA parameters in LEEM2000 and UView2002 (startupORB.txt). If Uview is configures such that it starts automatically LEEM2000 nd CCbridge you will find this file into the "..\proram files\Uview2000\"
The "NAMESERVICE" variable have to be accordingly updated the gui.bat file, e.g.:
java -cp SOMECLASSPATH gui.GUI -ORBInitRef NameService=corbaloc::SOMECOMPUTERNAME:PORTNUMBER/NameService.

COMPILE UMeasure

open a new command prompt window, change directory to "C:\GUI" and type: ant clean
This command cleans the old classes, archives and folders. If the operation is successful, you will see:

Then type ant dist, to compile. If the javac is successful, you will see:

CONFIGURE UMeasure INPUT

The configuration directory is defined in the gui.properties file in C:\gui\sources. The default value is C:\GUI\gui_conf. The file gui.properties must be edited BEFORE compiling Umeasure.
C:\GUI\gui_conf\umeasure_config.txt is the configuration file where you find all of the exeprimental parameters that are read or set.
C:\GUI\gui_conf\gapdata\ is the folder containing the calibration of the undulator gap as a function of the monochromator energy.
\gui_conf\umeasure_bcs.txt is the file containing the internet address, port number of the BCS server. The timeout of the communications with the BCS is set here.
C:\GUI\sources\umeasure_folders.txt is the file defining the working directories of the GUI:
- expRootFolder: where the data are saved.
- backupRootFolder: where the data is backed up.
- scansDir: where you can find script files.
- configFolder: where you can find all configuration files.
- iconsFolder: icons used by Umeasure.
A copy of the configuration files can be found here.