DALI User Manual: Installation Instructions

Instructions for Linux

This section covers installation instructions for the DALI server, C client libraries, and demo programs. Additionally, installation of Apache and the web-based administration system is available.

Section Shortcuts:

DALI Server Installation

DALI server software is available as an RPM for Linux. To install DALI run the following command on the Linux system.

rpm -i dali-1.1-1.i386.rpm

This will copy the DALI files to /usr/local/dali/. The files are organized into directories as follows:

/bin
Executables related to DALI. The DALI server is called dalid and is present in this directory.

/boards
The board configuration directory. See the Board Configuration section of the documentation for more information.

/boards-examples
Example board configuration files which can be copied to the board configuration directory and used as templates for the desired board configuration.

/alarms
The alarm configuration directory. See the Alarms section of the documentation for more information.

/alarms-examples
Example alarm configuration files which can be copied to the alarm configuration directory and used as templates for the desired alarm configuration.

/etc
Contains miscelaneous configuration files. The default location of the password file if user authentication will be used.

/ssl
Contains the temporary self-signed SSL certificate for use in testing DALI SSL support.

/manual
Contains html files and PHP files for the DALI administration web application admin PHP DALI demo pages. Apache with PHP is required to view these pages.

/htdocs
Contains html files for the DALI user manual. This is plain HTML which can be viewed with your web browser with Apache installed. Load the index.html file to get started.

Once the server is installed you can start the server by running the dalid binary in the /bin directory.

DALI C Client Installation

The DALI C client is installed with the DALI server using the instructions in the previous section. The following directories in /usr/local/dali are related to the client.

/include
Contains the header file for using the C/C++ client library. This library is documented later in this manual.

/lib
Contains the library file for the C/C++ client library. This library is documented later in this manual.

DALI C Client Demos Installation

The DALI C client demos are installed with the DALI server using the instructions in the previous section. These demos are executables and source code which can be used to as samples for your own DALI client software. The following directories in /usr/local/dali are related to the demos.

/demos
Contains executables and souce code for the demos.

DALI Apache Installation

For your convenience Diamond Systems is offering an RPM of Apache built with PHP support and configured to run the DALI web administration application. You can also use the standard Apache from Apache.org to do this. See the next section for instructions on how to configure an existing Apache install to support DALI.

To install DALI Apache run the following command on the Linux system.

rpm -i dali-apache-1.1-1.i386.rpm

This will copy the DALI files to /usr/local/dali-apache/. This is a standard install of the open source Apache webserver. The webserver has been compiled with PHP and OpenSSL support. The conf directory includes an httpd.conf file which has been customized to include httpd-dali.conf which includes the DALI specific configuration directives. The webserver is configured to map the /usr/local/dali/htdocs/dali to be accessable from the web.

The webserver can be started by running the following command.

/usr/local/dali-apache/bin/apachectl start

After running this command you will be able to access the DALI administration web application, PHP demo pages, and documentation via the web under the /dali/ directory of your webserver. For example, the demo pages in /usr/local/dali/htdocs/dali/demos will be visibile at the URL http://yourhost.example.com/dali/demos/.

Existing Apache Configuration

You can also download Apache direct from Apache.org or customize an existing Apache installation to support DALI. Follow these instructions to customize a standard Apache install for DALI.

Enable PHP support in Apache. Visit PHP.net for information on downloading and installing PHP support. Only PHP 4 is supported by DALI at this time.

Configure Apache to load the /usr/local/dali/htdocs and optionally the /usr/local/dali/manual directories to publish them on the web. The file /usr/local/dali/etc/httpd-dali.conf contains the Apache server configuration options required to do this. Copy this file to your Apache conf directory and modify your httpd.conf to include this file.

Finally, start the Apache server and check the logs for any errors. You should now be able to view the URL http://yoursite.example.com/dali/ to get access to the web administration application, PHP demos, and manual online.