heitml is connected to the Apache Web Server using the Apache API. This ensures maximum performance and optimal configurability. Once the configuration is complete, heitml pages are activated simply by placing them on the Web Server.
Packaged Installation Files
For some operating systems heitml comes as packaged installation files that can be installed very easily. These files are however bound to a specific version of the operating system, the database system and of Apache. We always try to make a distribution that works with the current version of an operating system. Please consult our download page for the most up to date information.
The distribution is split into two files, one containing the actual heitml program and the other one containing the heitml libraries, documentation, and demo files. The first file is named heitml-database-version.rpm and the second one heitml-data-version.rpm. Our download page will tell you exactly what files are needed.
In addition there is the generic version of heitml which works with any supported database system and with Apache. The Apache versions supported by the latest heitml/RADpage release, can be found on the heitml/RADpage Download page.heitml can be installed as dynamically linked module (DSO) or it can be statically linked into Apache. In the DSO case, Apache with installed DSO support is required including its include files (usually contained in a development package). For the statically linked version you need the Apache source distribution.
The distribution is split into two files, one containing the actual heitml program and the other one containing the heitml libraries, documentation, and demo files. The first file is named heitml-version-operating system-APACHE20.tar.gz (for Apache 2.x including 2.2), the second heitml-version-data.tar.gz. Our download page will tell you exactly what files are needed.
heitml can either be statically or dynamically linked into Apache. The advantage of dynamically linking is that your Apache does not need to be changed. Instead all what needs to be done is to add a file heitml.so to your system and to add a LoadModule directive to httpd.conf. The packaged versions of heitml always use this method to install heitml.
Using the packaged version of heitml, installation works almost automatically. For the generic version, please follow the instructions given in the README file. After installation you should be able to call up the heitml start page using http://yourcomputer/heitml2.1 in your browser.
Installation is however not yet finished! Please go to the Getting Started section and follow the instructions given there, to initialize the database and to check for certain security parameters.
heitml adds the configuration directives described in the Reference to the Apache configuration files. You can write them in httpd.conf, in the virtual hosts parts, or any .htaccess file (except heitml for the heitml directive). Please first read the general Configuration section. A valid configuration example is contained in the README file.
Activation of heitml pages
After configuration, put the desired heitml pages onto your Web server, just like ordinary HTML pages, and use the file extension .hei to identify them.
The initial heitml configuration is made for a Web Server, where the System or Web Administrator is the only person who can publish anything on that Server. The heitml language is designed in a manner that permits heitml pages to access only those resources allowed by the configuration options. There may still be bugs in the design or, more likely, in the implementation of heitml, however, so H.E.I. cannot guarantee this behavior. Furthermore, although it is considered unlikely, H.E.I. does not guarantee that heitml pages can do no harm. It remains your responsibility and, of course, the responsibility of the heitml author, to check all programs (including heitml pages) you put on your server. We do claim, however, that heitml pages are much easier to check than CGI scripts.
Some Web server installations permit people to export parts of their home directory to the Web, and .htaccess files can be used by them to configure the Web Server operation. Usually, all heitml configuration commands can be used in .htaccess files as well. If, however, you export directories to other users, you might want to deny access to heitml, or you might not want them to fiddle around with the heitml options. In fact, we strongly advise that you do this. Otherwise, users might be able to compromise the security of your Web Server. For this reason heitml offers the following two features:
The heitml command can not be used in .htaccess files. So if you decide to switch off heitml in a certain directory, it can not be switched on again within a .htaccess file.
If you have a multiuser machine and want to allow users to use heitml you should carefully read the Apache ISP Config section.
© 1996-2013 H.E.I. All Rights Reserved.