Augur Installation

The Augur server can be installed on Windows or Unix-based systems. After the server is installed, you can install the client on any type of machine.  Just point your web browser to Augur's server IP address, at port 8400.

Java™ Environment

Both the Augur server and client software run via Java to support the widest variety of operating systems, including mixed environments.

Augur Server

The 'java' command must be executable from the Augur server's shell.  This is automatic on Macs. For Windows, this is automatic once you install Java. For Unix-based systems you may have to create a soft-link for the java command at $AUGUR_HOME/bin/ or you can set the JAVA_HOME environmental variable for Augur's user account; point it to Java's home directory.  You can get the free Java Runtime Environment here: http://java.com/

Augur Client

For Windows and Unix/Linux clients, you can get the free Java Runtime Environment here: http://java.com/

Java Vendor

Macs should use the Java implementation supplied by Apple. All other platforms should use the Java implementation supplied by Oracle (formerly Sun). (There are known problems with the IBM version of Java on Linux, and other vendor implementations have not been tested.)

Java Version

The Augur server and clients require at least Java 5 (also called 1.5).  However, the lastest version, Java 6, is recommended.

64-bit Java

For 64-bit server operating systems, you may wish to install a 64-bit implementation of Java if available. This is fine for the server, but if you also want to run the Augur client on the same machine, then you must install the 32-bit version of Java first, followed by the 64-bit version on top of it. This is because only the 32-bit package provided by Oracle (Sun) contains the Java Web Start technology that launches the Augur client.

License Key

As a stand-alone server, Augur does not require a license key.  If you want to purchase a full support license, or network multiple Augur servers together as a cluster, please contact us.

Date & Time

Accurate date and time settings on your Augur client and server machines are especially important for the Configuration Editor to negotiate editing sessions. Ideally they should be synchronized via network time protocol (NTP), but close is OK.

Firewalls

Firewalls are not an issue is you run the Augur client and server on the same machine. However, communications between remote Augur clients and servers require several TCP/IP ports to be open on the server: 8400, and the range 1140-1145. These are configurable. NAT is not a problem for clients because each Augur server automatically keeps track of its accessible address, per client. However, currently, all Augur servers in a cluster must be able to communicate with each other directly.

Unix/Linux/Mac

1. Create a working directory, e.g. /opt/augur' or ~/augur'
2. Put the tarball into your working directory. Download (32 Mb)
3. Unzip/untar it: tar xvfz augur.tar.gz
4. Move into Augur's bin directory, then start the server: ./augur -start
5. At any time later, you can install the client by pointing your browser to the server's IP address, at port 8400.  For example: http://192.168.0.123:8400/
6. The default login user is "Admin", and the password is "augur" (both case-sensitive).

Uninstall

To uninstall the server, shutdown (~/bin/augur -stop), then delete the installation directory. To uninstall the client, launch Java Web Start (javaws -viewer) to delete the application.

Windows

1. Get the MSI file. Download (32 Mb)
2. Run the Augur.msi file, and follow the short installation wizard. 
3. The MSI will install and start an Augur "service".  The installer will also try to launch the client web site.
4. At any time later, you can install the client by pointing your browser to the server's IP address, at port 8400.  For example: http://192.168.0.123:8400/
5. The default login user is "Admin", and the password is "augur" (both case-sensitive).

Uninstall

To uninstall, use the "Add or Remove Programs" tool, in the Windows "Control Panel". The server name is "Augur Server", and the client name is "Augur". On the server, you may have to manually delete the installation directory, usually at C:\Program Files\Augur\