Please:
- Do not edit or alter the 'info' file - it is processed automatically after verification.
- All requests not submitted by the Contact Person may be discarded by our automatic system.
- Note that the access_prod program does not work properly if the set-up of the computer operating system is not consistent. The most common problems are discussed here.
The license key file, cr_info, needs to be present in the /usr/local/lib directory in order for the HKL/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.
The cr_info file will look like the following:
`~:Ddj@Qsw0fOouyHhnrwyadij@)WxBde46kM$PRSYdIORW468rxdeJL)=+[cemr
uvbjl$T-_efOP)v+gLQqrV=CFHJntzD4jpvaiRsaEFkop*a5H^+]59$Stw16pR-2
IKNRvdf5k^_WAGLM$O=1EGOopuY]EIn(0f!$&uc3iqu=2l^QYdi$Pr)]e6#oprA1
CcHmpsXCch@%=4j$%PrTucHN_z0cdHLms(uvxb5Kos(XB27qu]efjl@OPT1G9Lm$
^t)Wy01fJKLNs([EKLTY23hl@nWEJjrA4JO*-d7!PucG%^r=4gKmV3GOTxC3hJOq
(xBbe9M$&RTy3GIjLOq&sX08L%-X1ksXF6kl#-Af!P&R]b6kPXFJlPuv+z]7q_Xy
Dij9!^-XDiMSxGIOt_+zBJlt[c67JlU25@nRWwB5klqt)xzDJ!LPSWZDdMrW+13I
kpstXDf!tzD78rADGk^Qu[24Ffn$^-XYa02gjLl@)_ag@nqw16!LMm%RUZeN%xZ7
KPuYck@q()WAIQY6kM$)W]e8#$SX06i8@*]4Jl&vwcH@MoQRXF$&uvwxBDfijnp)
=19suxCD@#qZE8#%*T1klNOQqrtX1f5!$%x[DL#%*+glN&RWXDh9LOs)1gjp)WCI
#PSTtwa2!Nnq-Aae9^)Vx15GM^)xdejoruwacfintV[013mR_AEM^_19Lptwyglp
vXc4!@n%x[6kn(b3E7^Swa1CD@uYAbDEgjntVvaCcfKORs=y[4ijrwbgk%RW]5$r
sXYE89MN%Ptuvy0jmR_Ydjl&SV37KM&za2EFGgLp*]FNPVXcHJOTZF9nWCIJkoST
yeksUw06MnWxbg8nSuweh7jO=2FLmV]B24FLOR_zc:
To obtain the license key, you need to run the access_prod program on each machine that you plan to use for running any of the HKL programs. Executing the access_prod results in the following dialog (example answers in red, comments in italics):
enter the name of your institution: State University
enter the name of PI: John Doe (Principal Investigator or Group Leader)
enter the name of the person responsible for HKL maintenance: Jane Doe
enter names of all frame formats (detectors) you want to use: mar345 raxis4 (see below)
enter the number of detectors in your lab which are
currently supported by HKL package: 2
enter the name of the company from which you received
your license: HKL Research, Inc. (Other Possible Software Providers: Rigaku, etc.)
enter HKL version number: HKL-2000_720
if this is a temporary license, enter the number of days you request,
for a permanent license enter 'noexpir': noexpir
do you want to send an automatic e-mail to hkl@hkl-xray.com
in order to activate your license (y) ? n
If the answer is y (yes), the access_prod program may automatically send an e-mail with a request for an access file: cr_info. It may not always work, though. If the answer is n (no) the program will produce the following info file. You may save the info file and afterward 'manually' send it to hkl@hkl-xray.com.
An example of the 'info' file created by the access_prod program is given below (comments in italics) :
| HOST-NAME: vp4.med.state.edu | (extracted by the program - do not edit!) NOTE: the field is limited in length to 30 characters |
| HOST-ID: -2035379618 | (extracted by the program - do not edit!) |
| HOSTNAME: state.edu | (extracted by the program - do not edit!) |
| HW_PROV: linux | (extracted by the program - do not edit!) |
| CPU-SERIAL: linux,eth1,001762854231 | (extracted by the program - do not edit!) |
| INSTITUTION: State University | Licensee's Institution name |
| PI: John Doe | Principal Investigator or Group Leader |
| CONTACT: Jane Doe | Contact Person |
| DETECTORS: mar345 raxis4 | Detector Families |
| NO-OF-DET: 2 | Number of Detectors at Home Facility |
| PROVIDER: HKL Research, Inc. | License Provider: Rigaku, HKL, etc. |
| VERSION: HKL-2000_722 | Requested Version of the Program |
| EXPIR: noexpir | example: 60; Jan 1, 2023; noexpir |
The following are detector families that may be used in the above 'questionnaire':
raxis2 - RAXIS-II
raxis4 - RAXIS-IV
raxis5 - RAXIS-V
mar345 - MAR345 detector
This is only a partial list. You may also just simply write a description of the detector format, for example, Pilatus 6M, ADSC Q315, etc.
You should receive the cr_info file from us by return mail. Usually, it should take no more than 48h to receive cr_info. The cr_info file should be placed in the directory:
/usr/local/lib
You need system privileges to do so. In case of an emergency you may put this file into your home directory, but remember to ask a system administrator to copy cr_info into /usr/local/lib. Otherwise, nobody else will be able to run the HKL programs.