Installing CMPR on Windows
CMPR can be loaded in Windows either in a self-updating install or as a static install. The self-updating version causes the latest version of CMPR to be installed from the Argonne subversion server and also allows future updates to be installed from within the CMPR program. The static install package is updated less frequently and requires that you download and reinstall the package file to update. I recommend you use one of the self-updating install methods, as this is easier all around. If you do not have easy internet access, or you work inside a highly secure computing environment, you may be find that access to the subversion server is blocked and that your only option is to petition the rulers of the network to open access to the server (they really should) or to use the static install. Note that self-updating install actually includes two versions of CMPR, a stable version that is considered to be relatively bug-free and a development version that is actively being improved -- you can select between these versions from the Help menu. From time-to-time the improvements in the development version are transferred over to the stable version. In the static install, only the stable version is provided.
Self-Updating Install
1. Installing self-upgrading CMPR with the CMPR_UPDATING.EXE self-installer (preferred)
The easiest method to install CMPR is from a self-installing windows .EXE program. This program, alas, does not work on some versions of Windows -- 64 bit windows? If this is the case for you, see section 2, below. If you already have CMPR loaded on the computer you can opt to keep the old version, but you must load this version in a new location (or rename the older version). This process will fail if used in the location where the package has already been loaded.
Download http://11bm.xray.aps.anl.gov/downloads/cmpr_updating.exe and then run the program.
This program may need to be run from an administrator account, depending on the levels of security in force on your computer.
If you have an older version of CMPR on your computer (CMPR & LOGIC), this installer will not upgrade that version. Use the Control Panel to remove the old program or delete the folder.
The installer program offers only three options:
- Place CMPR shortcut on desktop?
The answer to this is a matter of your style. If you like an uncluttered desktop and like the Start menu, un-check the box (no). Note the shortcut (icon) can be moved from the desktop if you keep programs in collections.
- Destination Folder (Where should CMPR be installed?)
The default for this, C:\CMPR is where I suggest the software be installed. If you have another disk, any drive letter other than C: should also work. However, on some systems where security is tight, you may not have write access to that location. (In that case, you probably will not be able to write to C:\Program Files either), but C:\Documents and Settings\toby\CMPR (etc.) might work for you. (See question at bottom about "Do I have to install in c:\cmpr?" -- you may encounter bugs using directories with spaces in their names; these will be fixed if reported.) I have not tried mounting on network drives (
name\directory), except where the drives are mounted with a drive letter; bug reports are sought, but may not be easily fixed.
- Start Menu Folder (Which start menu should the the CMPR shortcut be placed?)
Again this is a matter of style. The default is to create a new folder, CMPR, and place the shortcut there.
The self-installer works in two steps. First it installs the svn (subversion) program and a few Batch files, then it runs a batch file named BOOTSTRAP.BAT, which loads all the CMPR files into the directory where BOOTSTRAP.BAT is located and then starts CMPR. Note that you can run this batch file at any time to update CMPR (best when CMPR is not running) or to complete the install if it fails should the internet connection be dropped during download.
2. Installing a self-upgrading CMPR from a zip file
For users where the above self-installing .EXE file refuses to run, the same files are provided in a .ZIP distribution, this contains the same files as above and works the same way, but requires more manual steps. It should not require admin access, though without it, you may be limited as to where the files can be installed. If you already have CMPR loaded on the computer you can opt to keep the old version, but you must load this version in a new location (or rename the older version). This process will fail if used in the location where the package has already been loaded.
- Download http://11bm.xray.aps.anl.gov/downloads/cmpr_win_updating.zip
- Open the downloaded (cmpr_win_updating.zip) file in the windows file browser, you should see a folder named CMPR (inside that folder is are two folders and three files).
- Drag (Copy) the CMPR folder to where you want to install the program. I normally use C:\, but it should work anywhere (please tell me of bugs that occur should use a directory name with spaces).
- Click on the BOOTSTRAP.BAT file in the new CMPR directory (be sure to use the new directory and not the one in the zipped folder) to download the CMPR files from the server. Note, this file can safely be rerun if a problem occurs in the download. In fact, whenever it is run, it will check the files on your computer against those on the repository and will download any updates. This will start CMPR as before when the download/update is complete.
- CMPR can be restarted by clicking on the StartCMPR.BAT file. Note that this file must stay in the folder where CMPR is installed, but you can create a shortcut to this file and move the shortcut anywhere.
- (optional) Make a desktop shortcut to run CMPR (see How to Create a Shortcut).
- (optional) Add shortcut(s) to Start Menu.
- Right-click on Start Menu, select open from list of choices
- Left-click on Programs folder
- Right-click on a blank section of folder and select new->folder to create place for shortcuts, name the new folder CMPR, etc.
- Copy the shortcut(s) created above from the desktop to the new folder in Start Menu\Programs
3. Installing from the subversion server with TortoiseSVN
It is also possible to install CMPR using the TortoiseSVN program without any direct downloads from the above site. This is described on a separate web page: Install CMPR with TortoiseSVN. This approach is recommended for developers who will want to upload their changes to CMPR (please contact me for upload access). The steps there must be done starting with an empty directory.
Installing the Static (non-updating) CMPR release
If you need to download a single file that will be used to install CMPR onto a computer where a connection cannot be made to the subversion server, a single zip file can be downloaded and moved to where it is needed. Directions below are for Windows XP and might need to be slightly different on other versions of Windows. This process can be used to overwrite an older CMPR install.
- Note that the subversion version number for this distribution can be determined by noting the latest number cmpr_win_Vxxxx\.zip in directory http://11bm.xray.aps.anl.gov/downloads/
- Open the file in the windows file browser, you should see a cmpr folder.
- Drag that folder to where you want to install CMPR. Any drive/directory on your computer should work,
but there might be some minor problems if you use a directory with spaces (such as C:\Program Files\CMPR). If you encounter such bugs, please report them so they can be fixed.
- (optional) Make a desktop shortcut to run CMPR (see How to Create a Shortcut).
- (optional) Add shortcut(s) to Start Menu.
- Right-click on Start Menu, select open from list of choices
- Left-click on Programs folder
- Right-click on a blank section of folder and select new->folder to create place for shortcuts, name the new folder CMPR, etc.
- Copy the shortcut(s) created above from the desktop to the new folder in Start Menu\Programs
Questions
- Do I have to install in c:\cmpr?
- You should be able to do this anywhere on your computer, but some help is likely needed in debugging places in the code that fail with directories names that contain spaces. Please help report them.
- Can I compile the executables rather than load them?
- Yes. You will need Tcl/Tk? with BLT, which you are on your own to build, and for the programs that CMPR uses you will need gfortran and gcc (G77 or another Fortran compiler will probably work). Note that
since the DICVOL06 source code is not distributed, you will need to use a compiled version. There is some advice on compiling in the .html files distributed in the cmpr/doc directory.
