The document provides steps for installing and configuring the Math-Bridge system, including installing Java, copying system files, compiling, configuring the system properties and ports, adding courses, starting and stopping the server, and finalizing the administrator user configuration. It also provides tips for production settings like adjusting JVM settings and enabling caching.

1. Joint Math-Bridge Training
Program
Michael Dietrich (DFKI)
Math-Bridge Installation
10.07.2015 Saarbrücken

2. Steps
• Java
• Copy System
• Copy Content
• Compile
• Configure System
• Add a course to the system
• Start/Stop System
• Finalize configuration

3. Install Java
• Check if JDK is present
• Open Terminal
• Type javac
• If not available
• Copy from Stick
• Install
• Repeat first step

4. JAVA_HOME
• Math-Bridge needs JAVA_HOME environment variable set
• Windows
• Right-Click Computer
• Choose Settings – Advanced
• System Variables
• Linux add to .bashrc
• export JAVA_HOME=/path/to/java
• Mac OS X: add to .profile
• If .profile is missing -> create it
• Add: export JAVA_HOME=/Library/Java/path/to/JDK

5. Copy
• Copy system
• Copy file system.zip to HDD
• Unpack
• Copy content
• Copy file content.zip to HDD
• Unpack
• Make sure system path does not contain spaces

6. Compile
• Windows
• Open Windows Explorer
• Navigate to MB install directory
• Open bin subdirectory
• Double Click ant.bat
• Linux/Mac
• Open a terminal
• Navigate to MB install directory (using cd)
• Type bin/ant

7. Configure Math-Bridge
• Change default port number
• open conf/server.xml
• Change startup/shutdown port
• Specify Administrator User
• Open conf/ActiveMath-individual.properties
• Add desired user name to user.admins

8. Add a course
• Copy unpacked contents of content.zip -> _MB-Root_/content
• Windows:
• Copy _MB-
Root_/content/LeAM_calculus/ContentDescr_LeAM_calculus.properties
-> _MB-Root_/conf
• Linux/Mac
• Symbolical Link ContentDescriptor file
• In Terminal
• Navigate to _MB-Root_/conf
• Type ln –s
../content/LeAM_calculus/ContentDescr_LeAM_calculus.properties
• Note: A system restart is required

9. Start Math-Bridge
• Start Math-Bridge
• bin/amStartup (*nix/Mac)
• doubleclick bin/activemath.bat (Windows)
• Shutdown Math-Bridge
• bin/amShutdown (*nix/Mac)
• close Math-Bridge server window (Windows)
• Restart Math-Bridge (*nix/Mac only)
• Bin/amRestart

10. Open Math-Bridge in browser
• Open FireFox
• Browse URL : http://localhost:8080

11. Finalize Configuration
• Create Admin User
• Check Admin User Rights
• Create additional users if need be

12. Further Configuration (Use of Proxy)
• Advertized URL
• If you use a proxy to access you system ie mathbridge.celtech.de
• Open conf/ActiveMath-individual.properties
• Locate line # advertizedURL = http://<your external
hostname>:8080/mathbridge/
• Remove comment (#)
• Enter proxied URL
• advertizedURL = http://mathbridge.celtech.de/mathbridge/
• Activate PDF Generation

13. Further Configuration(PDF generation)
• Activate PDF Generation
• Locate path to your pdflatex application
• Open conf/ActiveMath-individual.properties
• Locate property: output.pdflatex.command-path
• Remove comment (#)
• Enter path
• Note: there are examples given for Windows and *nix/Mac

14. Production Settings
Adjust JVM Settings for Server Mode
• In bin/amStartup:
• JAVA_OPTS="-Xms512m -Xmx2024m -server"
Enable EXPIRY and Check-For-Modified in FileServlet
• In conf/ActiveMath-individual.properties:
• FileServlet.expirytime_minutes = 240
• FileServlet.check-modified = true

15. Production Settings
Enable Velocity Cache
• In webapps/activemath3/WEB-INF/velocity.properties:
• file.resource.loader.cache = true
• file.resource.loader.modificationCheckInterval = -1 # or a large number
of seconds, e.g. 1800 for 30mins
• velocimacro.library.autoreload = false
Reduce Log4J logging
• In conf/log4j.properties:
• log4j.rootLogger=WARN, logfile
log4j.appender.logfile.MaxBackupIndex=9
log4j.appender.logfile.MaxFileSize=20MB

16. Update System
• Keep old version for safety
• Install new system
• Before first start
• Copy content directory to new version
• Copy conf/ActiveMath-individual.properties
• Copy Content Descriptor Files
• Copy data directory
• Ready to start