DESUMA Installation Instructions

From DESUMA Wiki
DESUMA Installation Instructions
Jump to: navigation, search


DESUMA Version 2.0


  • UMDES Executables - Integrated with DESUMA 2.0


Linux or Mac

  1. Open a Terminal and change the directory to the download location using the cd command.
  2. Use the command tar -xzvpf <Desuma_Download>. This will extract the contents of the archive. This will create the file "DESUMA.jar", and the two directories "plugins" and "lib".
  3. The program is called DESUMA.jar. On Mac and on some versions of Linux, you can simply double-click on the file to start the program. On some versions of Linux, it will be necessary to open the program through the command line, by using java -jar DESUMA.jar
  4. Upon opening the program for the first time, you will probably obtain an error saying "Could not find or load the following plugin (xml) files:...". Do not worry! This is easily fixed. Simply click "OK", wait for Desuma to load, go to Preferences -> Preferences..., and select the "Profile" tab. Now click on "Remove" where it says "Plugins Directory" to remove the current plugins file (the one which gave the error when Desuma opened). Finally, click "Browse" to replace this with the correct file, which is located at "<installation_directory>/plugins/umdes/umdes.xml." Note that you may need to make these files executable in the directory (for Mac): .../plugins/umdes/exec/mac ; this can done by running the command: chmod +x * in this directory.
  5. UPDATE - September 2022 for MAC

On Macs running more recent versions of macOS (such as Macs with the Apple M1 chip, based on our experience), macOS might put the executables in a quarantine state, for security reasons, since they were downloaded from the Internet. It may also not let you open the DESUMA.jar file. To open the DESUMA.jar file, you may need to go under Preferences / Security / Privacy to let the file run. Afterwards, you can solve the quarantine problem, if it is an issue. You can see if the executables are quarantined by running the command xattr on any executable file, in which case macOS will return To allow your Mac to run the UMDES commands, you should go the directory where your executables are located, per bullet item 4 above: .../plugins/umdes/exec/mac ; then run the following command to remove the quarantine extended attribute from the executables in that directory:

This fix has worked for us.


See the download page for installation instructions.

Trouble Shooting

  1. If you try to run a command and nothing happens when clicking "submit", the most likely reason is that the executable permissions are not set. This can be fixed without exiting the program. Simply open a terminal, cd to <installation_directory>/plugins/umdes/exec/<your_os>/, and type chmod u+x *. Try clicking "submit" again in Desuma.

DESUMA version 1.5


  • UMDES Executables - Integrated with DESUMA 1.5


  1. Click on the DESUMA installer link for your platform and save the file to your hard drive.
  2. Double click on the downloaded file to run the installer.
  3. Before using DESUMA, you must choose a working directory in which to store your data files (the default is the installation directory). To do this, in the DESUMA window open the View menu on the toolbar and click Options. (Note for Vista users: due to security restrictions in Vista, the working directory must be set outside the Program Files directory in order for DESUMA to operate correctly)

Java Downgrade Instructions

DESUMA does not work properly on all systems running Java 1.5 or above. If DESUMA does not work properly on your system please follow the following instructions to install Java 1.4:

  • Option 1 - Remove previous Java version and install Java 1.4
Follow these instructions if you do not need to continue running your current Java version, and instead want to run only Java 1.4:
  1. Go to Add/Remove Programs in the Control Panel and remove the current version of Java.
  2. Go to this website and click on the "Download J2SE JRE" link.
  3. Follow the onscreen instructions to download and run the appropriate installation executable.
  • Option 2 - Run Java 1.4 alongside current version of Java
Follow these instructions if you wish to continue running your current version of Java, and use Java 1.4 only for DESUMA:
  1. Go to this website and click on the "Download J2SE JRE" link.
  2. Follow the onscreen instructions to download and run the appropriate installation executable. Note the installation directory for later use.
  3. Create a shortcut to the DESUMA Jar file. If DESUMA was installed in the default directory, the path will be "C:\Program Files\desuma\DESUMA.jar".
  4. Right click on the shortcut you created and click properties.
  5. Click on the shortcut tab. Add the following string to the beginning of what is already in the Target box (with the quotation marks): "JAVADIR\bin\java.exe" -jar, where JAVADIR is the directory where Java 1.4 was installed. For example, if Java 1.4 was installed in C:\Program Files\Java\j2re1.4.2_17 and the Target box previously read "C:\Program Files\desuma\DESUMA.jar", when you are finished it should read (with the quotation marks): "C:\Program Files\Java\j2re1.4.2_17\bin\java.exe" -jar "C:\Program Files\desuma\DESUMA.jar"
  6. Use this shortcut whenever you wish to run DESUM.

DESUMA Contact Information: Please email questions to desuma-help AT umich DOT edu ( Although we are unable to provide full technical support, we will do our best to help.

Personal tools