Prerequisites

Before installing Umm, you must first insure that you have each of the following:

• PHP 4 or 5
• libxslt
• A database. Umm will work with any of the following:
  • PostgreSQL
  • MySQL
  • SQLite
  Be sure to install the PHP extension for whichever database you choose.
• One of the following mathml renderers:
  • GTKMathView
    If you choose GTKMathView, you will also need librsvg, and fonts for GTKMathView to use in rendering math.
  • WebEQ
• The PHP DOM extension (optional). This is required in PHP4 if you want UMM to parse CSS styles in order to match rendered math to the text size and background color that match its surroundings. Many PHP installations already have this extension installed; to tell if you have it, look through the output of "phpinfo()" for a section called "domxml". If you don't have the DOM extension and don't care about having UMM match the size and background color of math to its surroundings, you can turn the feature off in UMM's config file (uncheck all CSS and DOM boxes in the auto_config form), in which case the PHP DOM extension is not needed.

Installation

1. Unpack the Umm distribution into a directory somewhere under your web server's document root. It will unpack into a subdirectory named something like "umm-1.0", but you can rename it to something else if you want. Whatever you name it, that directory is called the Umm home directory.
2. In a browser, bring up the "admin" subdirectory of the Umm home directory. For example, if your web server's document root is /var/www/html and you unpacked Umm into "/var/www/html/umm-1.0", go to "http://your_server_name/umm-1.0/admin". This brings up the Umm admin page.
3. Click on the "auto_config" link on the Umm admin page, and follow the instructions there to create a config file for your Umm installation. Auto_config is a web page that will generate an Umm config file for you, after you enter the appropriate values in a form on the page. If you need more details about some of the parameters, visit the Configuration documentation page. When you have generated your config file, save it as "localconfig.php" in the Umm home directory.
4. Go back to the Umm admin page, and click on the update_browscap link and then follow the instructions to initialize your browscap database. More details are available on the Configuration documentation page.
5. Go back to the Umm admin page, and click the various example files to test your Umm installation.