Chapter 2. Installation on Linux

Table of Contents

Installation on Debian Linux

Installation on Debian Linux

Note

Chapter 1 has already covered all you need to get the Ambience system running. This chapter is for those users who wish to explore the tighter platform integration possibilities of running as a Linux service and want the file layout to follow established directory structures - for example /var/log for log files.

Ensure that you have unzip installed on your system as the installer is supplied as a zip file. To install unzip, run:

apt-get install unzip

either as root, or using sudo.

  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. Unzip the installer. For example,
    unzip ElixirAmbience-Debian-3.0.0.zip
    The deb file is extracted.
  3. As root or using sudo, install the deb file. For example, run
    dpkg -i elx-ambience_3.0-1_all.deb
    Ambience is now installed.
  4. As root or using sudo, start the ambience service. Run
    service ambience start
  5. To check if Elixir Ambience has started, run the command:
    ps aux | grep ambience
    The output should be similar to:
    xxx@systemadmin-Lenovo-G570:~$ ps aux | grep ambience
    xxx  5845  0.0  0.0  13644   952 pts/4  S+ 08:36   0:00 
    grep --color=auto ambience
    elixir   13497  0.4  5.4 3515832 439928 ? Sl   Mar17   8:50 
    /usr/bin/java -Delixir.home=/opt/elixir/ElixirAmbience 
    -Djetty.home=/opt/elixir/ElixirAmbience/jetty 
    -Dlogback.configurationFile=/etc/elixir/logback.xml 
    -Delx.stub.out=/var/log/elixir/ambience.txt 
    -Dvisualvm.display.name=Ambience 
    -jar elx-stub.jar org.eclipse.jetty.start.Main
    
  6. To auto start Ambience at boot, run the command:
    update-rc.d ambience defaults
    either as root, or using sudo.
  7. Open your browser and navigate to http://<hostname>:8080 to access the Ambience page.
  8. Once you enter your domain to login, the licence page appears as shown in Figure 1.1, “Licence Page”.:
  9. Enter your licence and click Deploy to deploy your licence.

After completing the deployment to the Linux platform, you will find that the default file locations have changed as follows:

The /etc/elixir directory contains the configuration files for Ambience.

The log files are stored in the /var/log/elixir directory.