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.
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.
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.
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.
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/
.
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.