Generic Installation Instructions

  1. Verify the SHA1 sum of the file that you received when you purchased Ambience, or when you downloaded a trial version, to ensure its integrity.
  2. Extract the file that you received when you purchased Ambience, or when you downloaded a trial version. For example, tar -xvzf elx-ambience-3.0.0.tgz. This extracts all the files into a directory called ElixirAmbience.

    If you downloaded a zip file, extract it with the extractor installed on your system. Linux users can run the command:

    unzip zip-file-name.zip

    to unzip the file. Substitute the correct zip file in the unzip command.

    Note

    Windows users should not extract the files into the \Program Files\ folder, as Microsoft controls the permissions of this subtree to prevent programs writing there. As the generic installation writes into the ElixirAmbience\data folder by default, this can cause access denied problems when working with regular user accounts.. Use any other folder (For example: C:\) to extract the files.
  3. Open a command prompt or terminal and navigate to the bin directory inside the ElixirAmbience directory. For example: cd ElixirAmbience/bin
  4. Start the server. On Unix run: sh run-server.sh. On windows run run-server.bat
  5. Open your browser and navigate to http://<hostname>:8080 to access the Ambience page.
  6. Once you enter your domain to login, the licence page appears as follows:

    Figure 1.1. Licence Page

    Licence Page
  7. Enter your licence and click Deploy to deploy your licence.

The etc directory inside the ElixirAmbience directory contains the configuration files for Ambience.

The log files are stored in the log directory inside the ElixirAmbience directory.