Installation

Install Dependencies – Java, MongoDB

Install Java 17

You need to download and install any Java 17 (including Open JDK) or higher for Ambience.

Install MongoDB

MongoDB is a document database with the scalability and flexibility that you want with the querying and indexing that you need. It uses JSON-like documents with schema.

Below are the steps to install MongoDB:

  1. Go to https://www.mongodb.com/download-center/community website.

  2. In the webpage, select MongoDB Community Server and select the following:

    • MongoDB 4.4.x or above (latest release is recommended)

    • Desired OS

    • Desired package

    Ambience also supports MongoDB Atlas.

  3. Click on the “Download” button.

  4. Installing the package:

    a. For MSI package, use the following steps:

    i.  Go to the directory where you downloaded the MongoDB installer
        (*.msi* file). By default, this is your downloads directory.
    
    ii. Double click on the *.msi* file and follow the instructions in the
        installer wizard.
    

    b. For ZIP package, use the following steps:

    i.  Extract the zip file into the desired location.
    
    ii. Create a folder "data/db" in the root directory of the location.
        This directory is required to save the database records.
    

    You may be prompted to install MongoDB Compass. It is an optional application.

  5. To run MongoDB:

    • From Windows Explorer/File Explorer, go to the “../MongoDB\Server/4.x/bin/” directory and double-click on mongod.exe.

    Depending on the OS, a command window will appear and may close after a few seconds.

    • For terminal window or command prompt for Windows, navigate to the “../MongoDB\Server/4.x/bin/” directory and execute the command “mongod.exe”.

    The MongoDB server runs at the default port 27017.

    For further details and advice on MongoDB installation, please refer to the MongoDB website.

Install Ambience

Contact our representatives for the Ambience suite. The Ambience comes in a form of a zip file. By default, the Ambience comes with a licence for a minimal set of modules that allows the administrator to log in and perform the basic setup. To acquire a larger set of modules, you will need to a new licence.

To install Ambience, extract the zip file to the desired location.