Apache Configuration

If you read this in your browser you should have done this already:

1.  Check out the UI from git

2.  Figure out Apache's document root. Common places are:

    - MacOS: /Library/WebServer/Documents
    - Linux: /var/www

3.  Create a new folder appsuite in Apache's document root

4.  Build the UI and the documentation with ant:

        ant -Dbuild=/Library/WebServer/Documents/appsuite all doc
    or
        export BUILD="/Library/WebServer/Documents/appsuite"
        ant all doc

5.  If everything works fine, the documentation should be at
    http://localhost/appsuite/doc.

If you read this in your browser you should have done this already:

1.  Check out the UI from git

2.  Figure out Apache's document root. Common places are:

    - MacOS: /Library/WebServer/Documents
    - Linux: /var/www

3.  Create a new folder appsuite in Apache's document root

4.  You need node.js to build the UI:

    For MacOS:

    - Visit https://sites.google.com/site/nodejsmacosx/
      and install stable version.

    - Open terminal

    - Set environment variable:
        export buildir="/Library/WebServer/Documents/appsuite"

    - Build UI:
      ./build.sh

    - Build documentation:
      ./build.sh doc

5.  If everything works fine, the documentation should be at
    http://localhost/appsuite/doc.

Now configure Apache:

1.  Make sure Apache loads the following modules:

    mod_proxy, mod_proxy_ajp, mod_expires, mod_deflate, mod_rewrite,
    mod_headers, mod_mime, and mod_setenvif

2.  Tell your Apache to process .htaccess files and how to connect to backend:

    ProxyPass /appsuite/api ajp://127.0.0.1:8009/ajax
    # optional parameters: retry=0 connectiontimeout=5 timeout=10

    <Directory /Library/WebServer/Documents/appsuite>
      Options None +FollowSymLinks
      AllowOverride Indexes FileInfo
    </Directory>

    Use the proper document root depending on your OS or custom configuration!

3.  If backend does not run on localhost (127.0.0.1),
    you have to adjust the ProxyPass directive.

4.  Restart Apache, e.g. sudo apachectl restart

And please double check everything you're doing!