Revision as of 15:57, 29 June 2009

Installation

Notes

• Use Xebra revision 78995 for this tutorial.
• This tutorial was tested with EiffelStudio 6.4.7.8600 ($ISE_EIFFEL) and eiffel_src ($EIFFEL_SRC) revision 78995.
• The env vars $EIFFEL_SRC, $ISE_EIFFEL, $ISE_PLATFORM and $ISE_LIBRARY are expected to be set.

Ubuntu 9.04 with Apache 2.2.11

Note

There is an installation script available for this type of configuration: https://svn.origo.ethz.ch/eiffelstudio/trunk/Src/framework/web/xebra/tools/scripts/install_xebra_ubuntu.sh

The script expects $XEBRA_DEV, $EIFFEL_SRC, $ISE_EIFFEL and $ISE_LIBRARY to be set. It will checkout xebra to $XEBRA_DEV, download and install apache to $XEBRA_DEV/httpd and compile the translator and the server. After the script was successfully run you have to edit $XEBRA_DEV/eiffel_projects/xebra_server/config.ini to match your configuration.

Checkout Xebra

• Define $XEBRA_DEV and checkout xebra from https://svn.origo.ethz.ch/eiffelstudio/trunk/Src/framework/web/xebra/ to $XEBRA_DEV

Setup Apache

Note: Mod_xebra does currently not run with the apache distribution that comes with ubuntu.

• Download apache unix source httpd-2.2.11 from http://httpd.apache.org/download.cgi
• Extract
• Define $APACHE2 where you want to install apache, e.g. to $XEBRA_DEV/httpd
• Run the following commands:

CFLAGS="-ggdb"./configure --prefix={insert path here}
make
make install

• Compile the module by running

cd $XEBRA_DEV/c_projects/mod_xebra
$APACHE2/bin/apxs -c -Wc,-ggdb -I$ISE_EIFFEL/studio/spec/$ISE_PLATFORM/include mod_xebra.c mod_xebra.h

• Install the module to apache by running

sudo $APACHE2/bin/apxs -i mod_xebra.la

• Add the following lines to Apache2.2\conf\httpd.conf:

LoadModule xebra_module modules/mod_xebra.so
AddHandler mod_xebra .xeb
XebraServer_port "55000"
XebraServer_host "localhost"
LogLevel debug
DirectoryIndex index.xeb
<Files ~ "\.(ini|e|ecf)$">
 Order allow,deny
 Deny from all
</Files>
<Directory ~ "EIFGENs">
 Order allow,deny
 Deny from all
</Directory>"

• Restart apache (if necessary, you need to stop and start instead of restart)

sudo $APACHE2/bin/apachectl restart

• Make sure no other apache is running, e.g. run

sudo apache2ctl stop

• Browse to http://localhost/test.xeb. You should see the Fail Whale and a message saying "Cannot connect to XebraServer. See apache error log."
• In order to be able to browse to the pre-created websites, copy the content of the folder xebra/httpd/htdocs to $APACHE2/htdocs.
• Hint: keep an eye on the apache error log tail -f $APACHE2/logs/error_log

Compile the Xebra Translator

cd $XEBRA_DEV/eiffel_projects/xebra_translator/
ec -config xebra_translator-voidunsafe.ecf  -target xebra_translator -c_compile -clean

Run the Xebra Server

• Open the file $XEBRA_DEV/eiffel_projects/xebra_server/config.ini and adapt translator, compiler, and webapps_root to your configuration.
• Compile the server

cd $XEBRA_DEV/eiffel_projects/xebra_server
ec -config xebra_server-voidunsafe.ecf -target xebra_server -c_compile -clean

• Open estudio in a terminal and open the project $XEBRA_DEV/eiffel_projects/xebra_server/xebra_server-voidunsafe.ecf
• Go to the Exceptions Handling dialog and disable DEVELOPER_EXCEPTION.
• Open the Execution Parameters dialog and set "config.ini -d 10" as argument.
• Run
• Browse to http://localhost/helloworld/hello.xeb. The server now translates, generates, compiles and finally runns the application.

Windows with Apache 2.2.11

Checkout Xebra

• Define $XEBRA_DEV and checkout xebra from https://svn.origo.ethz.ch/eiffelstudio/trunk/Src/framework/web/xebra/ to $XEBRA_DEV

Setup Apache

• Download apache httpd-2.2.11 windows binary from http://httpd.apache.org/download.cgi
• Install (Choose Custom Installation and install Build Headers and Libraries as well)
• Copy mod_xebra.so to your Apache2.2\modules folder.
• Add the following lines to Apache2.2\conf\httpd.conf:

LoadModule xebra_module modules/mod_xebra.so
AddHandler mod_xebra .xeb
XebraServer_port "55000"
XebraServer_host "localhost"
LogLevel debug
DirectoryIndex index.xeb
<Files ~ "\.(ini|e|ecf)$">
 Order allow,deny
 Deny from all
</Files>
<Directory ~ "EIFGENs">
 Order allow,deny
 Deny from all
</Directory>"

• Restart Apache
• Browse to http://localhost/test.xeb. You should see the Fail Whale and a message saying "Cannot connect to XebraServer. See apache error log."

Compile Xebra Translator

• Launch estudio and open the project $XEBRA_DEV/eiffel_projects/xebra_translator/xebra_translator-voidunsafe.ecf
• Compile

Run the Xebra Server

• Open the file $XEBRA_DEV/eiffel_projects/xebra_server/config.ini and adapt translator, compiler, and webapps_root to your configuration.
• Launch estudio and open the project $XEBRA_DEV/eiffel_projects/xebra_server/xebra_server-voidunsafe.ecf
• Go to the Exceptions Handling dialog and disable DEVELOPER_EXCEPTION.
• Open the Execution Parameters dialog and set "config.ini -d 10" as argument.
• Compile and run
• Browse to http://localhost/helloworld/hello.xeb. The server now translates, generates, compiles and finally runns the xebrawebpp application.

Windows with IIS7

no documentation yet