OS X Instructions

After download you will have a disk image Maud.dmg in your download folder, double click it to mount the image and a Finder window will open showing the Maud folder that you can copy or drag where you want Maud installed.
The Maud folder has the following structure:

  • Maud.app (the Maud application))
  • plugins (folder)

Move the maud directory with all the content in the place you are more comfortable with. Be sure you have the rights to write in that directory.
Double click the Maud.app to start Maud.
The first time Maud run, it will show the license agreement window and after you press the OK button it will show a dialog asking for a folder where to extract some files. These are files needed by Maud (databases, preferences etc. plus some examples) and to avoid to pollute your Maud folder it is advised to create another folder (it can be located inside the Maud one, we will call it the examples folder in the following). Be sure to enter inside the newly created example folder before pressing the Extract here button.
To check everything is ok, from the File menu, choose Open analysis… and choose the alzrc.par file inside the example folder. After loading it, press the calculator button in the toolbar to calculate the pattern. You should see a nice fit of the data with the residuals. You are set and ready to use Maud. If not check the troubleshooting section.

Tips (before or after installation)

  • If you have some troubles starting or running Maud and nothing you do can solve it, check first you have a startingLog file in the Maud folder. If there is not this file you don’t have a working java VM installed or something is wrong with the Maud.app, check the troubleshooting section. Otherwise you can send the startingLog file to the Maud author for help along with the content of the Maud console if you can reach the Maud main window.
  • How to activate the Maud console and get more output, info and errors reported: when the Maud main window opens, select console visible from the Interface menu.
  • How to use the same Maud installation for multiple users: install Maud in a folder accessible by all users and where all users have the rights to write in. Then each user has to start Maud using the Maud.app and on the first run extract all databases and examples in his own home folder (each user create a suitable folder somewhere and extract everything there). How it works: when Maud starts, it checks inside the Maud.app structured folder for a file named .maudpath_username where username is the User name. If the file does not exist, it will prompt for the license agreement and then ask for a folder where to extract the databases and example files. This folder is also used to store the preferences of Maud. The path to such folder is saved in the .maudpath_username file. This way each user will have his own folder with preferences etc. The unix environment should take care of running multiple instances of the program and each user keep separated files, analyses, preferences etc.

Troubleshooting
If something does not work, be sure you don’t have a corrupted download of Maud. Re-downloading it sometimes solves the corrupted download problem. But be aware of proxy caching the downloads, it means that if the corrupted download is in the cache of the proxy server, you will download again the same corrupted archive. Changing network for the download or forcing a refresh and download 1-2 days after may solve the caching problem.

  • Maud does not start using the Maud.app.
    Open a terminal window and type:
    java -version
    if java is a recognised command, then you may have the wrong version of Maud. For OS X version = 10.6 and 32/64bit you need to download Maud for OS X = 10.6, the other will not work.
  • I have java working but Maud does not start and I have the correct Maud as for the point before.This may be caused by a memory problem. You have a 32bit computer with a Java 32bit VM, but Maud is trying to allocate more than 2Gb of memory. You can change the memory settings of Maud, by right clicking over the Maud.app application and choose Show package folder. A folder will open, navigate inside the Contents folder and edit the Info.plist file. It is in xml format, go near the end of the file where you find:

    <key>VMOptions</key>
    <array>
    <string>-Xmx2048m</string>
    </array>

    in this case Maud is asking for 2Gb of memory with the -Xmx2048m string, change it to a value lower than 2 Gb, something like -Xmx1024m for 1Gb. Save the file, exit the folder and run Maud again. Otherwise see next point.
  • Maud start, but you are not able to arrive to the Maud main window.
    You may have a corrupted Maud installation, try to re-download and re-install it. Otherwise, check the startingLog file created inside the Maud folder when Maud starts and in case send it to the Maud author. Check the Tips section for more.
Posted in Installation Instructions

Leave a Reply

Your email address will not be published. Required fields are marked *

*