Contacts
Local contacts
Collaborators
Phonebook
Useful numbers
Links
Research
Highlights
Publications
Conferences
Image gallery
Users' area
Submitting a proposal
Sample suitability
Beamtime schedule
Shipping goods
Access request
Retrieving data
Manuals
Troubleshooting
Beamline procedures
Microscope procedures
Acquisition software
Data analysis
Spare lists
 
last update 15/02/2010
about | disclaimer

 INSTALLING BCSJava 

Using Umeasure
Startup
Umeasure basic usage
Running macros
Troubleshooting
  Installation instructions
Computer set-up
Installing LEEM2000 and UView2002
Installing UMeasure
Installing BCSJava

ABOUT

BCSjava is the program we use for controlling the beamline. It is used to move the mirrors, align the beamline, etc. Since 2005 BCSJava is not supported, because UMeasure can perform the majority of the tasks of BCS java.


GET WHAT YOU NEED

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".
which does not require username and password.

  1. Get BCSJava.zip and extract it to "C:\BCSjava". The program is ready to work. Two batch files are provided in order to allow control to the first (START_it.bat) or the second branch of the beamline (START_fr.bat).

    THE NEXT IS OPTIONAL (only needed for compiling BCSJava)

  2. A "build" utility called Apache ant is used to compile BCSJava 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

  3. 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\jdk15007. In order to do this on the beamline computers, you need to have administration privileges. At the time of writing, "BCSjava" was compiled successfully using JAVA SDK 1.5.007, but fails under Java6.

CONFIGURE THE COMPUTER - Update the path and the environment variables
(only needed for compiling BCSJava)
  1. 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; ...".

  2. 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\jdk15007\bin; ...".

  3. 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".

  4. In your Windows environment variables, create (or update) the variable CLASSPATH; In order to do this, please add: "..; C:\BcsJava;..." to the CLASSPATH.

  5. In your Windows environment variable, create a variable "JAVA_HOME" and set it to the compiler directory, e.g. "C:\javasoft\jdk15007". This is needed to tell ant which java compiler to use.

  6. Initialise ant. Open a dos window, and the command prompt just type "ant".

COMPILE BCSJava

Compile BCSjava: open a new command prompt window, change directory to "C:\BcsJava" and type:

ant clean

which cleans the old classes, archives and folders. If the operation is successful, then type:
ant dist.