For OSX

For OSX
Prev	Chapter 2. Installing Elixir Ambience	Next

Preparations

Before installing Elixir Ambience on OSX, be sure to set up the ZooKeeper properties:

Create two /.elixirtech directories and set permission owners as shown in the table below.

Table 2.3. /.elixirtech directories and permission owners

Directory	Permission Owner
/home/elixir/.elixirtech	elixir
/home/<user>/.elixirtech	<user>

In both /.elixirtech directories, create the zookeeper.properties file by copying the following contents into it. Fill in your host machine name and domain names. Leave the default ZooKeeper port as 2181 unless there is a clash with another service. The timeout indicates the heartbeat in milliseconds of the ZooKeeper cluster. If you need to configure a cluster, add more hosts here:

hosts=<machine-name>:2181
timeout=5000
domain.eno=<key>

Both copies of zookeeper.properties should contain exactly the same contents. Once the contents change, you should modify both copies.

Note

If you need to add more domains, follow the syntax below. <name> should only include letters and numbers, while <key> can include any characters. Domain name and key must be set before the domain is created, otherwise the domain is not accessible. Once set, the key cannot be changed. If a new key is needed, you need to export the contents of the domain using the old key, configure a new domain with a new key and import the contents with the new key in place.

domain.<name>=<key>

Install Elixir Ambience on OSX

To install Ambience on OSX, complete the following steps:

Open the Terminal window. Change to the directory that contains the install.sh file.
Type the following command lines to make the scripts in this directory executable:
```
chmod +x install.sh
```
Type the following command lines to run the install.sh file. The installation process start:
```
sudo ./install.sh
```
Look out for any error messages which might occur if existing services use the default ports that Elixir Ambience needs. Services will automatically start each time the computer is switched on.
Obtain and add any necessary JDBC drivers to the /var/elixir/lib folder.
If you have added new jars to the lib folder, run sudo ./stop.sh and then sudo ./start.sh for them to be included in the restarted environment.

Elixir Ambience is successfully installed.

Note

If you receive an error message during installation, saying “Unable to connect to ZooKeeper domain eno”, you might have to manually update IP address in the /etc/hosts file.

Uninstall Elixir Ambience from OSX

To uninstall Ambience from OSX, complete the following steps:

Export any repository contents that you wish to keep.
Open the Terminal window. Change to the directory that contains the uninstall.sh file.
Type the following command line to change the mode of the uninstall.sh file to be executable:
```
chmod +x uninstall.sh
```
Type the following command line to run the uninstall.sh file:
```
sudo ./uninstall.sh
```
This will stop all services and delete the program files. User files will still remain in case you with to reinstall or upgrade.
To remove all user files as well, run sudo ./wipe.sh after running the uninstall.sh file.

Elixir Ambience is successfully uninstalled.

On OSX operating system, you can also run the following files:

Table 2.4. Executable files on OSX

File	Description
reinstall.sh	This file uninstalls and then reinstalls the program. User configurations and repository contents are preserved. This script is useful to upgrade your installation when new versions are available.
start.sh	This file starts all the services.
stop.sh	This file stops all the services.
wipe.sh	This file wipes all zookeeper and repository contents. All user configuration will be deleted. You should only use this script after running uninstall.

Prev	Up	Next
For Windows	Home	Get Started