|MAC OS X||HKL2000_v720-Mac|
If you want to download version 712 or older, please see the Older HKL-2000 Instructions.
Downloading and unpacking HKL-2000 executable files
Download the HKL-2000 program package from the server hkl-xray.com. From a terminal, use command:
You may also download HKL-2000 directly from a web browser, clicking on the link below and signing in as user hkl2000ftp:
You can also use the web browser to download the program via the ftp protocol clicking on the link below and logging in as user hkl2000ftp:
After login you will see a list of directories for each version that contain the files:
Download by clicking on the package specific to your operating system.
You may also use terminal command "ftp" with the passive option:
ftp -p hkl.hkl-xray.com
To download the appropriate file use the get command:
> get HKL2000_v###-Linux-x86_64.tar.gz
After the file is downloaded, uncompress it by clicking on it, or by using the terminal command:
> tar -zxvf [filename].tar.gz or unzip [filename].zip for Mac
If necessary, move the unpacked installation directory to the desired location, for example, /usr/local.
To run HKL-2000 from a terminal use the command:
For convenience, a symbolic link may be defined, e.g. :
ln -s [installation directory]/bin/HKL2000 ~/Desktop/HKL2000
It is often convenient to add HKL-2000 to the PATH environmental variable by running the command below (it can be also incorporated in the login script):
source [installation directory]/hkl_setup.sh (for Bourne-type shells, e.g. bash) source [installation directory]/hkl_setup.csh (for C-type shells, e.g. csh, tcsh)
HKL-2000 also requires a directory hklint for site files. Its default location is /usr/local/hklint, but
it can be changed to an arbitrary directory by setting the environmental variable HKLDIR (requires administrative privileges). For example:
export HKLDIR=/home/joed/programs/hklint (for bash)
setenv HKLDIR /home/joed/programs/hklint (for cshell)
You can check how the environmental variables were set by typing the command:
env | grep HKL
To keep the values of the HKL environmental variables for subsequent logins, you should modify the configuration files for the shell you are using (~/.tcshrc, ~/.cshrc, or ~./bashrc).
The site file (def.site) of each detector/goniostat system (home or synchrotron) should be stored in its own sub-directory. It is good practice to appropriately name such directories in a way that allows to easily identify the specific facility and the detector, e.g:
A Site file (def.site) for synchrotron beamlines can be obtained from the beamline support staff.
Previous versions of HKL-2000 required defining HKLPATH environmental variable unless main programs (xdisp, denzo_3d and scalepack) were placed in the /usr/local/bin directory.
Currently, these programs are located in [installation directory]/bin directory and do not require HKLPATH to run.
Environmental variable HKLPATH should be unset if it points to an older version of HKL-2000. HKLPATH may still be used to define an alternate location for main programs.
The license key file, cr_info, needs to be present in the /usr/local/lib directory in order for the HKL-2000 programs to run. One cr_info file may contain information about many computers and detectors. The program looks through the cr_info file for the right combination of fields that matches the given detector family and computer information. Other fields are ignored. For more details, please see Access Key.
If you receive an error message "no display name and no $DISPLAY environment variable", it means that the X windows system is not working or is not configured properly. On Mac OS X, the X11 application should be running - in some cases, you may need to start the X11 application manually (from the Finder's Go menu, choose Applications, then choose Utilities and select X11). You should see the X11 icon in the dock, double click on it to open an xterm window and start HKL2000 from this window.