EiffelStudio: an EiffelSoftware project - User contributions [en]

Xebra Installation

2009-10-08T09:04:32Z

Fabioz: /* Ubuntu Installation Script */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

=Installations=
===There are two ways to install Xebra:===
*Automatic
** A script for Ubuntu 9.04 that sets up xebra and also installs apache
** A Windows Installer that contains xebra and apache and sets it up
*Manual (Step-by-step guide)
** Ubuntu 9.04 with Apache
** Windows with Apache
** Windows with IIS7

===A few notes===
*All of xebra is compiled with the -experiment option. We haven't tested to compile anything in non-experimental mode.
*Currently (rev 80407), for all types of installation you have to adapt a files in ISE_LIBRARY to make it work since there is a bug in the eiffel argument parser library: In the class ''ISE_EIFFEL/experimental/library/argument_parser/parsers/argument_base_parser.e'' in the feature ''arguments: ARRAY [STRING]'' replace the line
<code>
create Result.make (1, l_result.count)
</code>
with
<code>
create Result.make_filled ("", 1, l_result.count)
</code>

=Ubuntu Installation Script =
{{Note| This script was tested with Xebra revision 81057, EiffelStudio 6.5.8.945 and Ubuntu 9.04 (October 2009)}}

Download this script (the newest revision):
https://svn.eiffel.com/eiffelstudio/trunk/Src/framework/web/xebra/tools/scripts/linux/install_xebra_ubuntu.sh

The script expects $XEBRA_DEV, $ISE_EIFFEL and $ISE_LIBRARY to be set. Please make sure ''svn'', ''wget'', ''vim'' and ''tar'' are installed. Also, the path to your eiffel studio bin folder should be included in your PATH variable (usually $ISE_EIFFEL/studio/spec/$ISE_PLATFORM/bin).

The script will checkout xebra to $XEBRA_DEV, compile the server and translator, download, install and configure apache to $XEBRA_DEV/apache. Apache will be configured to listen on port 55000 (instead of 80) in order to not interfere with an already installed http server. After the script was successfully run you need to set $XEBRA_LIBRARY to $XEBRA_DEV/library.

To test you installation run
$XEBRA_DEV/bin/launch_apache.sh
$XEBRA_DEV/bin/launch_server.sh
and then browse to
http://localhost:55000/helloworld
The server will then start compiling the xebra precompile library and generate the helloworld webapp. It can take a while to do so the first time (If you want to see what's happening type 'debug_level 6' in the server console). While compiling you will see a page saying "Application 'helloworld' is compiling...". After a while hit F5 and you should see "Hello WORLD!" (or "Hello world!").

=Windows Installer =
{{Note| This installer was tested with Xebra revision 80545, EiffelStudio 6.5.8.294, on Windows XP SP2}}

Run the installer at:

https://svn.origo.ethz.ch/eiffelstudio/trunk/Src/framework/web/xebra/tools/installer/win/innosetup/output/XebraSetup.exe

To test your installation click "Launch Xebra Full" in the "Eiffel Xebra" folder in your start menu. This will launch apache and the xebra server and it will open "localhost:55000/helloworld" in your browser.
The server will then start compiling the xebra precompile library and generate the helloworld webapp. It can take a while to do so the first time (If you want to see what's happening type 'debug_level 6' in the server console). While compiling you will see a page saying "Application 'helloworld' is compiling...". After a while hit F5 and you should see "Hello WORLD!" (or "Hello world!").

=Manual Installation=
This guide expects Eiffel Studio to be installed to $ISE_EIFFEL and the source to be checked out to $EIFFEL_SRC (only the folder 'framework' is needed).

==Checkout Xebra==
* Define $XEBRA_DEV and checkout xebra from https://svn.eiffel.com/eiffelstudio/trunk/Src/framework/web/xebra/ to $XEBRA_DEV
* Define $XEBRA_LIBRARY to $XEBRA_DEV/eiffel_projects/library

==Install HTTP Server==
=== Ubuntu 9.04 with Apache 2.2.11 ===
Note:
* Mod_xebra does currently not run with the apache distribution that comes with ubuntu.

* Download apache unix source from http://httpd.apache.org/download.cgi
* Extract
* Define $APACHE2 where you want to install apache, e.g. to $XEBRA_DEV/apache
* Run the following commands in the extracted folder:
CFLAGS="-ggdb"
./configure --prefix=$APACHE2
make
make install
* Compile the module by running
cd $XEBRA_DEV/c_projects/apache_mod_xebra
$APACHE2/bin/apxs -c mod_xebra.c mod_xebra.h
* Install the module to apache by running
$APACHE2/bin/apxs -i mod_xebra.la
* Add the following lines to $APACHE2/conf/httpd.conf:
<code>
#Xebra Module
LoadModule xebra_module modules/mod_xebra.so

<IfModule xebra_module>
AddHandler mod_xebra .xeb
AddHandler mod_xebra .xrpc
XebraServer_port 55001
XebraServer_host "127.0.0.1"
XebraServer_max_upload_size 10000000
XebraServer_upload_path "/tmp"
DirectoryIndex index.xeb
<Files ~ "\.(ini|e|ecf)$">
Order allow,deny
Deny from all
</Files>
<Directory ~ "EIFGENs">
Order allow,deny
Deny from all
</Directory>
</IfModule>
</code>
* Also in httpd.conf, change ''DocumentRoot'' to ''{path to xebra}\www'' and don't forget the directory options below the line ''# This should be changed to whatever you set DocumentRoot to.''
* Create the directory ''/tmp'' or choose another temp upload directory.
* Restart apache
$APACHE2/bin/apachectl restart
* Browse to ''http://localhost/test.xeb''. You should see a message saying ''Cannot connect to XebraServer. See apache error log.''
* Hint: keep an eye on the apache error log
<code>
tail -f $APACHE2/logs/error_log
</code>

===Windows with Apache 2.2.11===

Note
* If mod_xebra.so was compiled with VS2008, it has a delay-load dependency on the Visual C++ 9.0 debug runtime library, msvcr90d.dll. This dll comes with Visual Studio 2008 C++ including the free Visual Studio 2008 C++ Express edition. This file can be copied in to the System32 directory. If this DLL is not found you will get an Apache error '''Cannot load C:/Xebra/httpd/modules/mod_xebra.so into server: This application has failed to start because the application configuration is incorrect.'''

* Download apache windows binary from http://httpd.apache.org/download.cgi
* Install (Choose Custom Installation and install Build Headers and Libraries as well)
* Copy $XEBRA_DEV/c_projects/apache_mod_xebra/mod_xebra.so to your Apache2.2\modules folder.
**Note: If you use a newer version of apache than 2.2.11 please compile mod_xebra yourself to avoid any possible errors, see [[Xebra Apache Module Windows]].
* Add the following lines to Apache2.2\conf\httpd.conf:
<code>
#Xebra Module
LoadModule xebra_module modules/mod_xebra.so

<IfModule xebra_module>
AddHandler mod_xebra .xeb
AddHandler mod_xebra .xrpc
XebraServer_port 55001
XebraServer_host "127.0.0.1"
XebraServer_max_upload_size 10000000
XebraServer_upload_path "c:\tmp"
DirectoryIndex index.xeb
<Files ~ "\.(ini|e|ecf)$">
Order allow,deny
Deny from all
</Files>
<Directory ~ "EIFGENs">
Order allow,deny
Deny from all
</Directory>
</IfModule>
</code>
* Also in httpd.conf, change ''DocumentRoot'' to ''{path to xebra}\www'' and don't forget the directory options below the line ''# This should be changed to whatever you set DocumentRoot to.''
* Create the directory ''c:\tmp'' or choose another temp upload directory.
* Restart Apache
* Browse to ''http://localhost/test.xeb''. You should see the a message saying ''Cannot connect to XebraServer. See apache error log.''

===Windows with IIS7===

* Open %XEBRA_DEV%\c_projects\iis_xebra_handler\XebraEventSourceInstaller\XebraEventSourceInstaller.sln in VS2008
* Compile and run (This will install the ''XebraHandler'' source to the Windows Event Log. This cannot be performed by the handler because it lacks permissions.)
* (Optional) Open %XEBRA_DEV%\c_projects\iis_xebra_handler\Xebra.sln in VS2008 and compile
* Create a new site in IIS and point it to %XEBRA_DEV%\www
* Copy %XEBRA_DEV%\c_projects\iis_xebra_handler\website\web.config to %XEBRA_DEV%\www
* Copy %XEBRA_DEV%\c_projects\iis_xebra_handler\website\bin to %XEBRA_DEV%\www

=== Mac OS X with Apache ===
Note:
* If you're using the version of EiffelStudio from MacPorts, environment variables must be set within the startup script. /Applications/MacPorts/Eiffel64/EiffelStudio/Contents/Resources/EiffelLauncher
* Save yourself a ton of hassle and just sudo chmod -R 777 * both the $ISE_EIFFEL and $EIFFEL_SRC directories.

* Get Apache V2 from Mac Ports
sudo port install apache2
* Copy $XEBRA_DEV/www/* to /opt/local/apache2/htdocs
* Compile the module by running
cd $XEBRA_DEV/c_projects/apache_mod_xebra
sudo /opt/local/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 /opt/local/apache2/bin/apxs -i mod_xebra.la
* Prepare to edit the protected httpd.conf file by running the command:
sudo /Applications/TextEdit.app/Contents/MacOS/TextEdit
Within TextEdit, which now is running under sudo, open /opt/local/apache2/conf/httpd.conf
* Add the following lines to /opt/local/apache2/conf/httpd.conf:
<code>
#Xebra Module
LoadModule xebra_module modules/mod_xebra.so

<IfModule xebra_module>
AddHandler mod_xebra .xeb
AddHandler mod_xebra .xrpc
XebraServer_port 55001
XebraServer_host "127.0.0.1"
XebraServer_max_upload_size 10000000
XebraServer_upload_path "/tmp"
DirectoryIndex index.xeb
<Files ~ "\.(ini|e|ecf)$">
Order allow,deny
Deny from all
</Files>
<Directory ~ "EIFGENs">
Order allow,deny
Deny from all
</Directory>
</IfModule>
</code>
* Also in httpd.conf, change ''DocumentRoot'' to ''{path to xebra}\www'' and don't forget the directory options below the line ''# This should be changed to whatever you set DocumentRoot to.''
* Create the directory /tmp or choose another temp upload directory.
* The default MacPorts apache install will listen on port 80
* Restart apache
sudo /opt/local/apache2/bin/apachectl restart
* Browse to http://localhost/test.xeb. You should see a message saying "Cannot connect to XebraServer. See apache error log."
* Hint: keep an eye on the apache error log
tail -f $APACHE2/logs/error_log

==Compile the Translator and Server ==
* First we need to compile the xebra precompile library:

'''Linux'''
<code>
ec -experiment -config $XEBRA_DEV/eiffel_projects/library/xebra_precompile/xebra_precompile.ecf -target xebra_precompile -c_compile -clean -precompile -project_path $XEBRA_DEV/eiffel_projects/library/xebra_precompile
</code>
'''Windows'''
<code>
ec -experiment -config %XEBRA_DEV%\eiffel_projects\library\xebra_precompile\xebra_precompile.ecf -target xebra_precompile -c_compile -clean -precompile -project_path %XEBRA_DEV%\eiffel_projects\library\xebra_precompile
</code>

* Then run:

'''Linux'''
<code>
ec -experiment -config $XEBRA_DEV/eiffel_projects/xebra_translator/xebra_translator.ecf -target xebra_translator -c_compile -clean -finalize -project_path $XEBRA_DEV/eiffel_projects/xebra_translator

ec -experiment -config $XEBRA_DEV/eiffel_projects/xebra_server/xebra_server.ecf -target xebra_server -c_compile -clean -finalize -project_path $XEBRA_DEV/eiffel_projects/xebra_server
</code>
'''Windows'''
<code>
ec -experiment -config %XEBRA_DEV%\eiffel_projects\xebra_translator\xebra_translator.ecf -target xebra_translator -c_compile -clean -finalize -project_path %XEBRA_DEV%\eiffel_projects\xebra_translator

ec -experiment -config %XEBRA_DEV%\eiffel_projects\xebra_server\xebra_server.ecf -target xebra_server -c_compile -clean -finalize -project_path %XEBRA_DEV%\eiffel_projects\xebra_server
</code>

==Test the installation==

To test you installation run

'''Windows'''
%XEBRA_DEV%\apache\bin\httpd.exe
%XEBRA_DEV%\eiffel_projects\xebra_server\EIFGENs\xebra_server\F_code\xebra_server.exe %XEBRA_DEV%\eiffel_projects\xebra_server\config.srv -d 6

'''Linux'''
$XEBRA_DEV/apache/bin/httpd
$XEBRA_DEV/eiffel_projects/xebra_server/EIFGENs/xebra_server/F_code/xebra_server $XEBRA_DEV/eiffel_projects/xebra_server/config.srv -d 6

and then open
http://localhost/helloworld
in your web browser.

The server will then start compiling the xebra precompile library and generate the helloworld webapp. It can take a minute to do so the first time. While compiling you will see a page saying "Application 'helloworld' is compiling...". After a while hit F5 and you should see "Hello WORLD!" (or "Hello world!").

Xebra Installation

2009-10-08T09:01:13Z

Fabioz: /* Ubuntu Installation Script */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

=Installations=
===There are two ways to install Xebra:===
*Automatic
** A script for Ubuntu 9.04 that sets up xebra and also installs apache
** A Windows Installer that contains xebra and apache and sets it up
*Manual (Step-by-step guide)
** Ubuntu 9.04 with Apache
** Windows with Apache
** Windows with IIS7

===A few notes===
*All of xebra is compiled with the -experiment option. We haven't tested to compile anything in non-experimental mode.
*Currently (rev 80407), for all types of installation you have to adapt a files in ISE_LIBRARY to make it work since there is a bug in the eiffel argument parser library: In the class ''ISE_EIFFEL/experimental/library/argument_parser/parsers/argument_base_parser.e'' in the feature ''arguments: ARRAY [STRING]'' replace the line
<code>
create Result.make (1, l_result.count)
</code>
with
<code>
create Result.make_filled ("", 1, l_result.count)
</code>

=Ubuntu Installation Script =
{{Note| This script was tested with Xebra revision 81056, EiffelStudio 6.5.8.945 and Ubuntu 9.04 (October 2009)}}

Download this script (the newest revision):
https://svn.eiffel.com/eiffelstudio/trunk/Src/framework/web/xebra/tools/scripts/linux/install_xebra_ubuntu.sh

The script expects $XEBRA_DEV, $ISE_EIFFEL and $ISE_LIBRARY to be set. Please make sure ''svn'', ''wget'', ''vim'' and ''tar'' are installed. Also, the path to your eiffel studio bin folder should be included in your PATH variable (usually $ISE_EIFFEL/studio/spec/$ISE_PLATFORM/bin).

The script will checkout xebra to $XEBRA_DEV, compile the server and translator, download, install and configure apache to $XEBRA_DEV/apache. Apache will be configured to listen on port 55000 (instead of 80) in order to not interfere with an already installed http server. After the script was successfully run you need to set $XEBRA_LIBRARY to $XEBRA_DEV/library.

To test you installation run
$XEBRA_DEV/bin/launch_apache.sh
$XEBRA_DEV/bin/launch_server.sh
and then browse to
http://localhost:55000/helloworld
The server will then start compiling the xebra precompile library and generate the helloworld webapp. It can take a while to do so the first time (If you want to see what's happening type 'debug_level 6' in the server console). While compiling you will see a page saying "Application 'helloworld' is compiling...". After a while hit F5 and you should see "Hello WORLD!" (or "Hello world!").

=Windows Installer =
{{Note| This installer was tested with Xebra revision 80545, EiffelStudio 6.5.8.294, on Windows XP SP2}}

Run the installer at:

https://svn.origo.ethz.ch/eiffelstudio/trunk/Src/framework/web/xebra/tools/installer/win/innosetup/output/XebraSetup.exe

To test your installation click "Launch Xebra Full" in the "Eiffel Xebra" folder in your start menu. This will launch apache and the xebra server and it will open "localhost:55000/helloworld" in your browser.
The server will then start compiling the xebra precompile library and generate the helloworld webapp. It can take a while to do so the first time (If you want to see what's happening type 'debug_level 6' in the server console). While compiling you will see a page saying "Application 'helloworld' is compiling...". After a while hit F5 and you should see "Hello WORLD!" (or "Hello world!").

=Manual Installation=
This guide expects Eiffel Studio to be installed to $ISE_EIFFEL and the source to be checked out to $EIFFEL_SRC (only the folder 'framework' is needed).

==Checkout Xebra==
* Define $XEBRA_DEV and checkout xebra from https://svn.eiffel.com/eiffelstudio/trunk/Src/framework/web/xebra/ to $XEBRA_DEV
* Define $XEBRA_LIBRARY to $XEBRA_DEV/eiffel_projects/library

==Install HTTP Server==
=== Ubuntu 9.04 with Apache 2.2.11 ===
Note:
* Mod_xebra does currently not run with the apache distribution that comes with ubuntu.

* Download apache unix source from http://httpd.apache.org/download.cgi
* Extract
* Define $APACHE2 where you want to install apache, e.g. to $XEBRA_DEV/apache
* Run the following commands in the extracted folder:
CFLAGS="-ggdb"
./configure --prefix=$APACHE2
make
make install
* Compile the module by running
cd $XEBRA_DEV/c_projects/apache_mod_xebra
$APACHE2/bin/apxs -c mod_xebra.c mod_xebra.h
* Install the module to apache by running
$APACHE2/bin/apxs -i mod_xebra.la
* Add the following lines to $APACHE2/conf/httpd.conf:
<code>
#Xebra Module
LoadModule xebra_module modules/mod_xebra.so

<IfModule xebra_module>
AddHandler mod_xebra .xeb
AddHandler mod_xebra .xrpc
XebraServer_port 55001
XebraServer_host "127.0.0.1"
XebraServer_max_upload_size 10000000
XebraServer_upload_path "/tmp"
DirectoryIndex index.xeb
<Files ~ "\.(ini|e|ecf)$">
Order allow,deny
Deny from all
</Files>
<Directory ~ "EIFGENs">
Order allow,deny
Deny from all
</Directory>
</IfModule>
</code>
* Also in httpd.conf, change ''DocumentRoot'' to ''{path to xebra}\www'' and don't forget the directory options below the line ''# This should be changed to whatever you set DocumentRoot to.''
* Create the directory ''/tmp'' or choose another temp upload directory.
* Restart apache
$APACHE2/bin/apachectl restart
* Browse to ''http://localhost/test.xeb''. You should see a message saying ''Cannot connect to XebraServer. See apache error log.''
* Hint: keep an eye on the apache error log
<code>
tail -f $APACHE2/logs/error_log
</code>

===Windows with Apache 2.2.11===

Note
* If mod_xebra.so was compiled with VS2008, it has a delay-load dependency on the Visual C++ 9.0 debug runtime library, msvcr90d.dll. This dll comes with Visual Studio 2008 C++ including the free Visual Studio 2008 C++ Express edition. This file can be copied in to the System32 directory. If this DLL is not found you will get an Apache error '''Cannot load C:/Xebra/httpd/modules/mod_xebra.so into server: This application has failed to start because the application configuration is incorrect.'''

* Download apache windows binary from http://httpd.apache.org/download.cgi
* Install (Choose Custom Installation and install Build Headers and Libraries as well)
* Copy $XEBRA_DEV/c_projects/apache_mod_xebra/mod_xebra.so to your Apache2.2\modules folder.
**Note: If you use a newer version of apache than 2.2.11 please compile mod_xebra yourself to avoid any possible errors, see [[Xebra Apache Module Windows]].
* Add the following lines to Apache2.2\conf\httpd.conf:
<code>
#Xebra Module
LoadModule xebra_module modules/mod_xebra.so

<IfModule xebra_module>
AddHandler mod_xebra .xeb
AddHandler mod_xebra .xrpc
XebraServer_port 55001
XebraServer_host "127.0.0.1"
XebraServer_max_upload_size 10000000
XebraServer_upload_path "c:\tmp"
DirectoryIndex index.xeb
<Files ~ "\.(ini|e|ecf)$">
Order allow,deny
Deny from all
</Files>
<Directory ~ "EIFGENs">
Order allow,deny
Deny from all
</Directory>
</IfModule>
</code>
* Also in httpd.conf, change ''DocumentRoot'' to ''{path to xebra}\www'' and don't forget the directory options below the line ''# This should be changed to whatever you set DocumentRoot to.''
* Create the directory ''c:\tmp'' or choose another temp upload directory.
* Restart Apache
* Browse to ''http://localhost/test.xeb''. You should see the a message saying ''Cannot connect to XebraServer. See apache error log.''

===Windows with IIS7===

* Open %XEBRA_DEV%\c_projects\iis_xebra_handler\XebraEventSourceInstaller\XebraEventSourceInstaller.sln in VS2008
* Compile and run (This will install the ''XebraHandler'' source to the Windows Event Log. This cannot be performed by the handler because it lacks permissions.)
* (Optional) Open %XEBRA_DEV%\c_projects\iis_xebra_handler\Xebra.sln in VS2008 and compile
* Create a new site in IIS and point it to %XEBRA_DEV%\www
* Copy %XEBRA_DEV%\c_projects\iis_xebra_handler\website\web.config to %XEBRA_DEV%\www
* Copy %XEBRA_DEV%\c_projects\iis_xebra_handler\website\bin to %XEBRA_DEV%\www

=== Mac OS X with Apache ===
Note:
* If you're using the version of EiffelStudio from MacPorts, environment variables must be set within the startup script. /Applications/MacPorts/Eiffel64/EiffelStudio/Contents/Resources/EiffelLauncher
* Save yourself a ton of hassle and just sudo chmod -R 777 * both the $ISE_EIFFEL and $EIFFEL_SRC directories.

* Get Apache V2 from Mac Ports
sudo port install apache2
* Copy $XEBRA_DEV/www/* to /opt/local/apache2/htdocs
* Compile the module by running
cd $XEBRA_DEV/c_projects/apache_mod_xebra
sudo /opt/local/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 /opt/local/apache2/bin/apxs -i mod_xebra.la
* Prepare to edit the protected httpd.conf file by running the command:
sudo /Applications/TextEdit.app/Contents/MacOS/TextEdit
Within TextEdit, which now is running under sudo, open /opt/local/apache2/conf/httpd.conf
* Add the following lines to /opt/local/apache2/conf/httpd.conf:
<code>
#Xebra Module
LoadModule xebra_module modules/mod_xebra.so

<IfModule xebra_module>
AddHandler mod_xebra .xeb
AddHandler mod_xebra .xrpc
XebraServer_port 55001
XebraServer_host "127.0.0.1"
XebraServer_max_upload_size 10000000
XebraServer_upload_path "/tmp"
DirectoryIndex index.xeb
<Files ~ "\.(ini|e|ecf)$">
Order allow,deny
Deny from all
</Files>
<Directory ~ "EIFGENs">
Order allow,deny
Deny from all
</Directory>
</IfModule>
</code>
* Also in httpd.conf, change ''DocumentRoot'' to ''{path to xebra}\www'' and don't forget the directory options below the line ''# This should be changed to whatever you set DocumentRoot to.''
* Create the directory /tmp or choose another temp upload directory.
* The default MacPorts apache install will listen on port 80
* Restart apache
sudo /opt/local/apache2/bin/apachectl restart
* Browse to http://localhost/test.xeb. You should see a message saying "Cannot connect to XebraServer. See apache error log."
* Hint: keep an eye on the apache error log
tail -f $APACHE2/logs/error_log

==Compile the Translator and Server ==
* First we need to compile the xebra precompile library:

'''Linux'''
<code>
ec -experiment -config $XEBRA_DEV/eiffel_projects/library/xebra_precompile/xebra_precompile.ecf -target xebra_precompile -c_compile -clean -precompile -project_path $XEBRA_DEV/eiffel_projects/library/xebra_precompile
</code>
'''Windows'''
<code>
ec -experiment -config %XEBRA_DEV%\eiffel_projects\library\xebra_precompile\xebra_precompile.ecf -target xebra_precompile -c_compile -clean -precompile -project_path %XEBRA_DEV%\eiffel_projects\library\xebra_precompile
</code>

* Then run:

'''Linux'''
<code>
ec -experiment -config $XEBRA_DEV/eiffel_projects/xebra_translator/xebra_translator.ecf -target xebra_translator -c_compile -clean -finalize -project_path $XEBRA_DEV/eiffel_projects/xebra_translator

ec -experiment -config $XEBRA_DEV/eiffel_projects/xebra_server/xebra_server.ecf -target xebra_server -c_compile -clean -finalize -project_path $XEBRA_DEV/eiffel_projects/xebra_server
</code>
'''Windows'''
<code>
ec -experiment -config %XEBRA_DEV%\eiffel_projects\xebra_translator\xebra_translator.ecf -target xebra_translator -c_compile -clean -finalize -project_path %XEBRA_DEV%\eiffel_projects\xebra_translator

ec -experiment -config %XEBRA_DEV%\eiffel_projects\xebra_server\xebra_server.ecf -target xebra_server -c_compile -clean -finalize -project_path %XEBRA_DEV%\eiffel_projects\xebra_server
</code>

==Test the installation==

To test you installation run

'''Windows'''
%XEBRA_DEV%\apache\bin\httpd.exe
%XEBRA_DEV%\eiffel_projects\xebra_server\EIFGENs\xebra_server\F_code\xebra_server.exe %XEBRA_DEV%\eiffel_projects\xebra_server\config.srv -d 6

'''Linux'''
$XEBRA_DEV/apache/bin/httpd
$XEBRA_DEV/eiffel_projects/xebra_server/EIFGENs/xebra_server/F_code/xebra_server $XEBRA_DEV/eiffel_projects/xebra_server/config.srv -d 6

and then open
http://localhost/helloworld
in your web browser.

The server will then start compiling the xebra precompile library and generate the helloworld webapp. It can take a minute to do so the first time. While compiling you will see a page saying "Application 'helloworld' is compiling...". After a while hit F5 and you should see "Hello WORLD!" (or "Hello world!").

Xebra Installation

2009-09-01T19:32:38Z

Fabioz: /* Ubuntu Installation Script */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

=Installations=
===There are two ways to install Xebra:===
*Automatic
** A script for Ubuntu 9.04 that sets up xebra and also installs apache
** A Windows Installer that contains xebra and apache and sets it up
*Manual (Step-by-step guide)
** Ubuntu 9.04 with Apache
** Windows with Apache
** Windows with IIS7

===A few notes===
*All of xebra is compiled with the -experiment option. We haven't tested to compile anything in non-experimental mode.
*Currently (rev 80407), for all types of installation you have to adapt a files in ISE_LIBRARY to make it work since there is a bug in the eiffel argument parser library: In the class ''ISE_EIFFEL/experimental/library/argument_parser/parsers/argument_base_parser.e'' in the feature ''arguments: ARRAY [STRING]'' replace the line
<code>
create Result.make (1, l_result.count)
</code>
with
<code>
create Result.make_filled ("", 1, l_result.count)
</code>

=Ubuntu Installation Script =
{{Note| This script was tested with Xebra revision 80570, EiffelStudio 6.5.8.294 and Ubuntu 9.04 (August 2009)}}

Run this script (the current revision):
https://svn.eiffel.com/eiffelstudio/trunk/Src/framework/web/xebra/tools/scripts/linux/install_xebra_ubuntu.sh

The script expects $XEBRA_DEV, $ISE_EIFFEL and $ISE_LIBRARY to be set. Please make sure ''svn'', ''wget'', ''vim'' and ''tar'' are installed. Also, the path to your eiffel studio bin folder should be included in your PATH variable.

The script will checkout xebra to $XEBRA_DEV, compile the server and translator, download, install and configure apache to $XEBRA_DEV/apache. Apache will be configured to listen on port 55000 (instead of 80) in order to not interfere with an already installed http server. After the script was successfully run you need to set $XEBRA_LIBRARY to $XEBRA_DEV/library.

To test you installation run
$XEBRA_DEV/bin/launch_apache.sh
$XEBRA_DEV/bin/launch_server.sh
and then browse to
http://localhost:55000/helloworld
The server will then start compiling the xebra precompile library and generate the helloworld webapp. It can take a while to do so the first time (If you want to see what's happening type 'debug_level 6' in the server console). While compiling you will see a page saying "Application 'helloworld' is compiling...". After a while hit F5 and you should see "Hello WORLD!" (or "Hello world!").

=Windows Installer =
{{Note| This installer was tested with Xebra revision 80545, EiffelStudio 6.5.8.294, on Windows XP SP2}}

Run the installer at:

https://svn.origo.ethz.ch/eiffelstudio/trunk/Src/framework/web/xebra/tools/installer/win/innosetup/output/XebraSetup.exe

To test your installation click "Launch Xebra Full" in the "Eiffel Xebra" folder in your start menu. This will launch apache and the xebra server and it will open "localhost:55000/helloworld" in your browser.
The server will then start compiling the xebra precompile library and generate the helloworld webapp. It can take a while to do so the first time (If you want to see what's happening type 'debug_level 6' in the server console). While compiling you will see a page saying "Application 'helloworld' is compiling...". After a while hit F5 and you should see "Hello WORLD!" (or "Hello world!").

=Manual Installation=
This guide expects Eiffel Studio to be installed to $ISE_EIFFEL and the source to be checked out to $EIFFEL_SRC (only the folder 'framework' is needed).

==Checkout Xebra==
* Define $XEBRA_DEV and checkout xebra from https://svn.eiffel.com/eiffelstudio/trunk/Src/framework/web/xebra/ to $XEBRA_DEV
* Define $XEBRA_LIBRARY to $XEBRA_DEV/eiffel_projects/library

==Install HTTP Server==
=== Ubuntu 9.04 with Apache 2.2.11 ===
Note:
* Mod_xebra does currently not run with the apache distribution that comes with ubuntu.

* Download apache unix source from http://httpd.apache.org/download.cgi
* Extract
* Define $APACHE2 where you want to install apache, e.g. to $XEBRA_DEV/apache
* Run the following commands in the extracted folder:
CFLAGS="-ggdb"
./configure --prefix=$APACHE2
make
make install
* Compile the module by running
cd $XEBRA_DEV/c_projects/apache_mod_xebra
$APACHE2/bin/apxs -c mod_xebra.c mod_xebra.h
* Install the module to apache by running
$APACHE2/bin/apxs -i mod_xebra.la
* Add the following lines to $APACHE2/conf/httpd.conf:
<code>
#Xebra Module
LoadModule xebra_module modules/mod_xebra.so

<IfModule xebra_module>
AddHandler mod_xebra .xeb
AddHandler mod_xebra .xrpc
XebraServer_port 55001
XebraServer_host "127.0.0.1"
XebraServer_max_upload_size 10000000
XebraServer_upload_path "/tmp"
DirectoryIndex index.xeb
<Files ~ "\.(ini|e|ecf)$">
Order allow,deny
Deny from all
</Files>
<Directory ~ "EIFGENs">
Order allow,deny
Deny from all
</Directory>
</IfModule>
</code>
* Also in httpd.conf, change ''DocumentRoot'' to ''{path to xebra}\www'' and don't forget the directory options below the line ''# This should be changed to whatever you set DocumentRoot to.''
* Create the directory ''/tmp'' or choose another temp upload directory.
* Restart apache
$APACHE2/bin/apachectl restart
* Browse to ''http://localhost/test.xeb''. You should see a message saying ''Cannot connect to XebraServer. See apache error log.''
* Hint: keep an eye on the apache error log
<code>
tail -f $APACHE2/logs/error_log
</code>

===Windows with Apache 2.2.11===

Note
* If mod_xebra.so was compiled with VS2008, it has a delay-load dependency on the Visual C++ 9.0 debug runtime library, msvcr90d.dll. This dll comes with Visual Studio 2008 C++ including the free Visual Studio 2008 C++ Express edition. This file can be copied in to the System32 directory. If this DLL is not found you will get an Apache error '''Cannot load C:/Xebra/httpd/modules/mod_xebra.so into server: This application has failed to start because the application configuration is incorrect.'''

* Download apache windows binary from http://httpd.apache.org/download.cgi
* Install (Choose Custom Installation and install Build Headers and Libraries as well)
* Copy $XEBRA_DEV/c_projects/apache_mod_xebra/mod_xebra.so to your Apache2.2\modules folder.
**Note: If you use a newer version of apache than 2.2.11 please compile mod_xebra yourself to avoid any possible errors, see [[Xebra Apache Module Windows]].
* Add the following lines to Apache2.2\conf\httpd.conf:
<code>
#Xebra Module
LoadModule xebra_module modules/mod_xebra.so

<IfModule xebra_module>
AddHandler mod_xebra .xeb
AddHandler mod_xebra .xrpc
XebraServer_port 55001
XebraServer_host "127.0.0.1"
XebraServer_max_upload_size 10000000
XebraServer_upload_path "c:\tmp"
DirectoryIndex index.xeb
<Files ~ "\.(ini|e|ecf)$">
Order allow,deny
Deny from all
</Files>
<Directory ~ "EIFGENs">
Order allow,deny
Deny from all
</Directory>
</IfModule>
</code>
* Also in httpd.conf, change ''DocumentRoot'' to ''{path to xebra}\www'' and don't forget the directory options below the line ''# This should be changed to whatever you set DocumentRoot to.''
* Create the directory ''c:\tmp'' or choose another temp upload directory.
* Restart Apache
* Browse to ''http://localhost/test.xeb''. You should see the a message saying ''Cannot connect to XebraServer. See apache error log.''

===Windows with IIS7===

* Open %XEBRA_DEV%\c_projects\iis_xebra_handler\XebraEventSourceInstaller\XebraEventSourceInstaller.sln in VS2008
* Compile and run (This will install the ''XebraHandler'' source to the Windows Event Log. This cannot be performed by the handler because it lacks permissions.)
* (Optional) Open %XEBRA_DEV%\c_projects\iis_xebra_handler\Xebra.sln in VS2008 and compile
* Create a new site in IIS and point it to %XEBRA_DEV%\www
* Copy %XEBRA_DEV%\c_projects\iis_xebra_handler\website\web.config to %XEBRA_DEV%\www
* Copy %XEBRA_DEV%\c_projects\iis_xebra_handler\website\bin to %XEBRA_DEV%\www

=== Mac OS X with Apache ===
Note:
* If you're using the version of EiffelStudio from MacPorts, environment variables must be set within the startup script. /Applications/MacPorts/Eiffel64/EiffelStudio/Contents/Resources/EiffelLauncher
* Save yourself a ton of hassle and just sudo chmod -R 777 * both the $ISE_EIFFEL and $EIFFEL_SRC directories.

* Get Apache V2 from Mac Ports
sudo port install apache2
* Copy $XEBRA_DEV/www/* to /opt/local/apache2/htdocs
* Compile the module by running
cd $XEBRA_DEV/c_projects/apache_mod_xebra
sudo /opt/local/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 /opt/local/apache2/bin/apxs -i mod_xebra.la
* Prepare to edit the protected httpd.conf file by running the command:
sudo /Applications/TextEdit.app/Contents/MacOS/TextEdit
Within TextEdit, which now is running under sudo, open /opt/local/apache2/conf/httpd.conf
* Add the following lines to /opt/local/apache2/conf/httpd.conf:
<code>
#Xebra Module
LoadModule xebra_module modules/mod_xebra.so

<IfModule xebra_module>
AddHandler mod_xebra .xeb
AddHandler mod_xebra .xrpc
XebraServer_port 55001
XebraServer_host "127.0.0.1"
XebraServer_max_upload_size 10000000
XebraServer_upload_path "/tmp"
DirectoryIndex index.xeb
<Files ~ "\.(ini|e|ecf)$">
Order allow,deny
Deny from all
</Files>
<Directory ~ "EIFGENs">
Order allow,deny
Deny from all
</Directory>
</IfModule>
</code>
* Also in httpd.conf, change ''DocumentRoot'' to ''{path to xebra}\www'' and don't forget the directory options below the line ''# This should be changed to whatever you set DocumentRoot to.''
* Create the directory /tmp or choose another temp upload directory.
* The default MacPorts apache install will listen on port 80
* Restart apache
sudo /opt/local/apache2/bin/apachectl restart
* Browse to http://localhost/test.xeb. You should see a message saying "Cannot connect to XebraServer. See apache error log."
* Hint: keep an eye on the apache error log
tail -f $APACHE2/logs/error_log

==Compile the Translator and Server ==
* First we need to compile the xebra precompile library:

'''Linux'''
<code>
ec -experiment -config $XEBRA_DEV/eiffel_projects/library/xebra_precompile/xebra_precompile.ecf -target xebra_precompile -c_compile -clean -precompile -project_path $XEBRA_DEV/eiffel_projects/library/xebra_precompile
</code>
'''Windows'''
<code>
ec -experiment -config %XEBRA_DEV%\eiffel_projects\library\xebra_precompile\xebra_precompile.ecf -target xebra_precompile -c_compile -clean -precompile -project_path %XEBRA_DEV%\eiffel_projects\library\xebra_precompile
</code>

* Then run:

'''Linux'''
<code>
ec -experiment -config $XEBRA_DEV/eiffel_projects/xebra_translator/xebra_translator.ecf -target xebra_translator -c_compile -clean -finalize -project_path $XEBRA_DEV/eiffel_projects/xebra_translator

ec -experiment -config $XEBRA_DEV/eiffel_projects/xebra_server/xebra_server.ecf -target xebra_server -c_compile -clean -finalize -project_path $XEBRA_DEV/eiffel_projects/xebra_server
</code>
'''Windows'''
<code>
ec -experiment -config %XEBRA_DEV%\eiffel_projects\xebra_translator\xebra_translator.ecf -target xebra_translator -c_compile -clean -finalize -project_path %XEBRA_DEV%\eiffel_projects\xebra_translator

ec -experiment -config %XEBRA_DEV%\eiffel_projects\xebra_server\xebra_server.ecf -target xebra_server -c_compile -clean -finalize -project_path %XEBRA_DEV%\eiffel_projects\xebra_server
</code>

==Test the installation==

To test you installation run

'''Windows'''
%XEBRA_DEV%\apache\bin\httpd.exe
%XEBRA_DEV%\eiffel_projects\xebra_server\EIFGENs\xebra_server\F_code\xebra_server.exe %XEBRA_DEV%\eiffel_projects\xebra_server\config.srv -d 6

'''Linux'''
$XEBRA_DEV/apache/bin/httpd
$XEBRA_DEV/eiffel_projects/xebra_server/EIFGENs/xebra_server/F_code/xebra_server $XEBRA_DEV/eiffel_projects/xebra_server/config.srv -d 6

and then open
http://localhost/helloworld
in your web browser.

The server will then start compiling the xebra precompile library and generate the helloworld webapp. It can take a minute to do so the first time. While compiling you will see a page saying "Application 'helloworld' is compiling...". After a while hit F5 and you should see "Hello WORLD!" (or "Hello world!").

Xebra Benchmarks

2009-09-01T19:20:09Z

Fabioz: /* Settings */

[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

==Environment==
*Windows 7 64Bit
*Xebra revision 80570
*Eiffel Studio 6.5.7.9743 GPL Edition - windows
*Eiffel src revision 80570
*IIS 7.5.7100
*Apache 2.2.11
*ApacheBench 2.3
*Tomcat 6.0 with Apache-Coyote/1.1

==Settings==
*Using experimental library
*Server and webapp are finalized. Webapp is unmanaged.

The page has the following content:
<code>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 STRICT//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"></meta>
<title>Xebra Hello World Application</title>
</head>
<body>
Hello {print 'WORLD' or 'world' depending on current time}
</body>
</html>
</code>

==Results==

{| class="wikitable"
! Xebra Webapp on Apache
! Xebra Webapp on IIS
! Java JSP Webapp on Tomcat
! Static Page on Apache
|-
|
1000 requests, concurrency level 1
|
|
|-
|
<code>
Document Path: /helloworld/index.xeb
Document Length: 331 bytes

Concurrency Level: 1
Time taken for tests: 9.290 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 716000 bytes
HTML transferred: 331000 bytes
Requests per second: 107.64 [#/sec] (mean)
Time per request: 9.290 [ms] (mean)
Time per request: 9.290 [ms] (mean, across all concurrent requests)
Transfer rate: 75.27 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.3 0 1
Processing: 7 9 1.4 9 21
Waiting: 7 9 1.4 9 21
Total: 7 9 1.4 9 21

Percentage of the requests served within a certain time (ms)
50% 9
66% 10
75% 10
80% 10
90% 11
95% 11
98% 14
99% 16
100% 21 (longest request)
</code>
|
<code>
Document Path: /hellworld/index.xeb
Document Length: 848 bytes

Concurrency Level: 1
Time taken for tests: 9.243 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 1087000 bytes
HTML transferred: 848000 bytes
Requests per second: 108.19 [#/sec] (mean)
Time per request: 9.243 [ms] (mean)
Time per request: 9.243 [ms] (mean, across all concurrent requests)
Transfer rate: 114.84 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.4 0 1
Processing: 7 9 4.0 8 63
Waiting: 7 9 4.0 8 63
Total: 7 9 4.0 8 63

Percentage of the requests served within a certain time (ms)
50% 8
66% 9
75% 9
80% 9
90% 10
95% 13
98% 16
99% 31
100% 63 (longest request)
</code>
|
<code>
Document Path: /examples/jsp/jsp2/simpletag/hello.jsp
Document Length: 334 bytes

Concurrency Level: 1
Time taken for tests: 1.247 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 555000 bytes
HTML transferred: 334000 bytes
Requests per second: 801.88 [#/sec] (mean)
Time per request: 1.247 [ms] (mean)
Time per request: 1.247 [ms] (mean, across all concurrent requests)
Transfer rate: 434.61 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.4 0 1
Processing: 0 1 0.3 1 4
Waiting: 0 1 0.4 1 4
Total: 1 1 0.4 1 5

Percentage of the requests served within a certain time (ms)
50% 1
66% 1
75% 1
80% 1
90% 2
95% 2
98% 2
99% 2
100% 5 (longest request)</code>
|
<code>
Document Path: /index.html
Document Length: 332 bytes

Concurrency Level: 1
Time taken for tests: 0.893 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 594000 bytes
HTML transferred: 332000 bytes
Requests per second: 1120.35 [#/sec] (mean)
Time per request: 0.893 [ms] (mean)
Time per request: 0.893 [ms] (mean, across all concurrent requests)
Transfer rate: 649.89 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.3 0 1
Processing: 0 1 0.6 1 11
Waiting: 0 1 0.6 1 11
Total: 0 1 0.5 1 11

Percentage of the requests served within a certain time (ms)
50% 1
66% 1
75% 1
80% 1
90% 1
95% 1
98% 1
99% 1
100% 11 (longest request)
</code>
|-
|
1000 requests, concurrency level 10
|
|
|-
|
<code>
Document Path: /helloworld/index.xeb
Document Length: 331 bytes

Concurrency Level: 10
Time taken for tests: 8.527 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 716000 bytes
HTML transferred: 331000 bytes
Requests per second: 117.27 [#/sec] (mean)
Time per request: 85.273 [ms] (mean)
Time per request: 8.527 [ms] (mean, across all concurrent requests)
Transfer rate: 82.00 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.4 0 1
Processing: 31 84 10.5 87 107
Waiting: 31 84 10.5 87 107
Total: 31 85 10.5 87 107

Percentage of the requests served within a certain time (ms)
50% 87
66% 90
75% 93
80% 95
90% 98
95% 101
98% 103
99% 104
100% 107 (longest request)
</code>
|
<code>
Document Path: /hellworld/index.xeb
Document Length: 848 bytes

Concurrency Level: 10
Time taken for tests: 5.491 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 1087000 bytes
HTML transferred: 848000 bytes
Requests per second: 182.11 [#/sec] (mean)
Time per request: 54.912 [ms] (mean)
Time per request: 5.491 [ms] (mean, across all concurrent requests)
Transfer rate: 193.31 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 1 1.8 0 27
Processing: 10 54 20.2 49 169
Waiting: 9 53 20.2 49 169
Total: 11 54 20.2 50 169

Percentage of the requests served within a certain time (ms)
50% 50
66% 57
75% 63
80% 67
90% 81
95% 96
98% 111
99% 124
100% 169 (longest request)
</code>
|
<code>
Document Path: /examples/jsp/jsp2/simpletag/hello.jsp
Document Length: 334 bytes

Concurrency Level: 10
Time taken for tests: 0.828 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 555000 bytes
HTML transferred: 334000 bytes
Requests per second: 1207.55 [#/sec] (mean)
Time per request: 8.281 [ms] (mean)
Time per request: 0.828 [ms] (mean, across all concurrent requests)
Transfer rate: 654.48 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.5 0 2
Processing: 1 8 1.6 8 19
Waiting: 0 5 2.4 5 19
Total: 2 8 1.6 8 19

Percentage of the requests served within a certain time (ms)
50% 8
66% 8
75% 9
80% 9
90% 10
95% 12
98% 14
99% 15
100% 19 (longest request)</code>
|
<code>
Document Path: /index.html
Document Length: 332 bytes

Concurrency Level: 10
Time taken for tests: 0.559 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 594000 bytes
HTML transferred: 332000 bytes
Requests per second: 1790.21 [#/sec] (mean)
Time per request: 5.586 [ms] (mean)
Time per request: 0.559 [ms] (mean, across all concurrent requests)
Transfer rate: 1038.46 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.4 0 2
Processing: 1 5 2.9 5 87
Waiting: 1 5 2.9 5 87
Total: 2 5 2.9 5 87

Percentage of the requests served within a certain time (ms)
50% 5
66% 6
75% 6
80% 6
90% 6
95% 7
98% 9
99% 11
100% 87 (longest request)
</code>
|-
|
1000 requests, concurrency level 100
|
|
|-
|
<code>
Document Path: /helloworld/index.xeb
Document Length: 331 bytes

Concurrency Level: 100
Time taken for tests: 8.970 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 716000 bytes
HTML transferred: 331000 bytes
Requests per second: 111.49 [#/sec] (mean)
Time per request: 896.973 [ms] (mean)
Time per request: 8.970 [ms] (mean, across all concurrent requests)
Transfer rate: 77.95 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.4 0 2
Processing: 54 846 175.6 912 1018
Waiting: 54 846 175.6 912 1018
Total: 54 846 175.6 912 1018

Percentage of the requests served within a certain time (ms)
50% 912
66% 929
75% 940
80% 972
90% 994
95% 1002
98% 1014
99% 1016
100% 1018 (longest request)
</code>
|
<code>
Document Path: /hellworld/index.xeb
Document Length: 848 bytes

Concurrency Level: 100
Time taken for tests: 5.517 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 1087000 bytes
HTML transferred: 848000 bytes
Requests per second: 181.27 [#/sec] (mean)
Time per request: 551.660 [ms] (mean)
Time per request: 5.517 [ms] (mean, across all concurrent requests)
Transfer rate: 192.42 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 1 2.0 0 23
Processing: 19 526 97.3 544 672
Waiting: 19 525 97.2 544 672
Total: 19 527 97.6 546 672

Percentage of the requests served within a certain time (ms)
50% 546
66% 559
75% 567
80% 574
90% 594
95% 613
98% 628
99% 644
100% 672 (longest request)
</code>
|
<code>
Document Path: /examples/jsp/jsp2/simpletag/hello.jsp
Document Length: 334 bytes

Concurrency Level: 100
Time taken for tests: 1.068 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 555000 bytes
HTML transferred: 334000 bytes
Requests per second: 936.01 [#/sec] (mean)
Time per request: 106.836 [ms] (mean)
Time per request: 1.068 [ms] (mean, across all concurrent requests)
Transfer rate: 507.31 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.8 0 15
Processing: 5 101 89.4 81 404
Waiting: 2 72 90.6 45 393
Total: 5 101 89.3 81 404

Percentage of the requests served within a certain time (ms)
50% 81
66% 83
75% 84
80% 85
90% 331
95% 356
98% 384
99% 400
100% 404 (longest request)</code>
|
<code>
Document Path: /index.html
Document Length: 332 bytes

Concurrency Level: 100
Time taken for tests: 0.647 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 594000 bytes
HTML transferred: 332000 bytes
Requests per second: 1544.49 [#/sec] (mean)
Time per request: 64.746 [ms] (mean)
Time per request: 0.647 [ms] (mean, across all concurrent requests)
Transfer rate: 895.93 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.4 0 3
Processing: 21 61 10.1 63 84
Waiting: 20 61 10.1 63 84
Total: 21 61 10.1 63 84

Percentage of the requests served within a certain time (ms)
50% 63
66% 63
75% 65
80% 67
90% 71
95% 75
98% 78
99% 79
100% 84 (longest request)
</code>

|}

Xebra Benchmarks

2009-09-01T19:14:34Z

Fabioz: /* Environment */

[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

==Environment==
*Windows 7 64Bit
*Xebra revision 80570
*Eiffel Studio 6.5.7.9743 GPL Edition - windows
*Eiffel src revision 80570
*IIS 7.5.7100
*Apache 2.2.11
*ApacheBench 2.3
*Tomcat 6.0 with Apache-Coyote/1.1

==Settings==
*Using experimental library
*Server and webapps are finalized. Webapp is unmanaged.

The page has the following content:
<code>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 STRICT//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"></meta>
<title>Xebra Hello World Application</title>
</head>
<body>
Hello {print 'WORLD' or 'world' depending on current time}
</body>
</html>
</code>

==Results==

{| class="wikitable"
! Xebra Webapp on Apache
! Xebra Webapp on IIS
! Java JSP Webapp on Tomcat
! Static Page on Apache
|-
|
1000 requests, concurrency level 1
|
|
|-
|
<code>
Document Path: /helloworld/index.xeb
Document Length: 331 bytes

Concurrency Level: 1
Time taken for tests: 9.290 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 716000 bytes
HTML transferred: 331000 bytes
Requests per second: 107.64 [#/sec] (mean)
Time per request: 9.290 [ms] (mean)
Time per request: 9.290 [ms] (mean, across all concurrent requests)
Transfer rate: 75.27 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.3 0 1
Processing: 7 9 1.4 9 21
Waiting: 7 9 1.4 9 21
Total: 7 9 1.4 9 21

Percentage of the requests served within a certain time (ms)
50% 9
66% 10
75% 10
80% 10
90% 11
95% 11
98% 14
99% 16
100% 21 (longest request)
</code>
|
<code>
Document Path: /hellworld/index.xeb
Document Length: 848 bytes

Concurrency Level: 1
Time taken for tests: 9.243 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 1087000 bytes
HTML transferred: 848000 bytes
Requests per second: 108.19 [#/sec] (mean)
Time per request: 9.243 [ms] (mean)
Time per request: 9.243 [ms] (mean, across all concurrent requests)
Transfer rate: 114.84 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.4 0 1
Processing: 7 9 4.0 8 63
Waiting: 7 9 4.0 8 63
Total: 7 9 4.0 8 63

Percentage of the requests served within a certain time (ms)
50% 8
66% 9
75% 9
80% 9
90% 10
95% 13
98% 16
99% 31
100% 63 (longest request)
</code>
|
<code>
Document Path: /examples/jsp/jsp2/simpletag/hello.jsp
Document Length: 334 bytes

Concurrency Level: 1
Time taken for tests: 1.247 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 555000 bytes
HTML transferred: 334000 bytes
Requests per second: 801.88 [#/sec] (mean)
Time per request: 1.247 [ms] (mean)
Time per request: 1.247 [ms] (mean, across all concurrent requests)
Transfer rate: 434.61 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.4 0 1
Processing: 0 1 0.3 1 4
Waiting: 0 1 0.4 1 4
Total: 1 1 0.4 1 5

Percentage of the requests served within a certain time (ms)
50% 1
66% 1
75% 1
80% 1
90% 2
95% 2
98% 2
99% 2
100% 5 (longest request)</code>
|
<code>
Document Path: /index.html
Document Length: 332 bytes

Concurrency Level: 1
Time taken for tests: 0.893 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 594000 bytes
HTML transferred: 332000 bytes
Requests per second: 1120.35 [#/sec] (mean)
Time per request: 0.893 [ms] (mean)
Time per request: 0.893 [ms] (mean, across all concurrent requests)
Transfer rate: 649.89 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.3 0 1
Processing: 0 1 0.6 1 11
Waiting: 0 1 0.6 1 11
Total: 0 1 0.5 1 11

Percentage of the requests served within a certain time (ms)
50% 1
66% 1
75% 1
80% 1
90% 1
95% 1
98% 1
99% 1
100% 11 (longest request)
</code>
|-
|
1000 requests, concurrency level 10
|
|
|-
|
<code>
Document Path: /helloworld/index.xeb
Document Length: 331 bytes

Concurrency Level: 10
Time taken for tests: 8.527 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 716000 bytes
HTML transferred: 331000 bytes
Requests per second: 117.27 [#/sec] (mean)
Time per request: 85.273 [ms] (mean)
Time per request: 8.527 [ms] (mean, across all concurrent requests)
Transfer rate: 82.00 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.4 0 1
Processing: 31 84 10.5 87 107
Waiting: 31 84 10.5 87 107
Total: 31 85 10.5 87 107

Percentage of the requests served within a certain time (ms)
50% 87
66% 90
75% 93
80% 95
90% 98
95% 101
98% 103
99% 104
100% 107 (longest request)
</code>
|
<code>
Document Path: /hellworld/index.xeb
Document Length: 848 bytes

Concurrency Level: 10
Time taken for tests: 5.491 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 1087000 bytes
HTML transferred: 848000 bytes
Requests per second: 182.11 [#/sec] (mean)
Time per request: 54.912 [ms] (mean)
Time per request: 5.491 [ms] (mean, across all concurrent requests)
Transfer rate: 193.31 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 1 1.8 0 27
Processing: 10 54 20.2 49 169
Waiting: 9 53 20.2 49 169
Total: 11 54 20.2 50 169

Percentage of the requests served within a certain time (ms)
50% 50
66% 57
75% 63
80% 67
90% 81
95% 96
98% 111
99% 124
100% 169 (longest request)
</code>
|
<code>
Document Path: /examples/jsp/jsp2/simpletag/hello.jsp
Document Length: 334 bytes

Concurrency Level: 10
Time taken for tests: 0.828 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 555000 bytes
HTML transferred: 334000 bytes
Requests per second: 1207.55 [#/sec] (mean)
Time per request: 8.281 [ms] (mean)
Time per request: 0.828 [ms] (mean, across all concurrent requests)
Transfer rate: 654.48 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.5 0 2
Processing: 1 8 1.6 8 19
Waiting: 0 5 2.4 5 19
Total: 2 8 1.6 8 19

Percentage of the requests served within a certain time (ms)
50% 8
66% 8
75% 9
80% 9
90% 10
95% 12
98% 14
99% 15
100% 19 (longest request)</code>
|
<code>
Document Path: /index.html
Document Length: 332 bytes

Concurrency Level: 10
Time taken for tests: 0.559 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 594000 bytes
HTML transferred: 332000 bytes
Requests per second: 1790.21 [#/sec] (mean)
Time per request: 5.586 [ms] (mean)
Time per request: 0.559 [ms] (mean, across all concurrent requests)
Transfer rate: 1038.46 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.4 0 2
Processing: 1 5 2.9 5 87
Waiting: 1 5 2.9 5 87
Total: 2 5 2.9 5 87

Percentage of the requests served within a certain time (ms)
50% 5
66% 6
75% 6
80% 6
90% 6
95% 7
98% 9
99% 11
100% 87 (longest request)
</code>
|-
|
1000 requests, concurrency level 100
|
|
|-
|
<code>
Document Path: /helloworld/index.xeb
Document Length: 331 bytes

Concurrency Level: 100
Time taken for tests: 8.970 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 716000 bytes
HTML transferred: 331000 bytes
Requests per second: 111.49 [#/sec] (mean)
Time per request: 896.973 [ms] (mean)
Time per request: 8.970 [ms] (mean, across all concurrent requests)
Transfer rate: 77.95 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.4 0 2
Processing: 54 846 175.6 912 1018
Waiting: 54 846 175.6 912 1018
Total: 54 846 175.6 912 1018

Percentage of the requests served within a certain time (ms)
50% 912
66% 929
75% 940
80% 972
90% 994
95% 1002
98% 1014
99% 1016
100% 1018 (longest request)
</code>
|
<code>
Document Path: /hellworld/index.xeb
Document Length: 848 bytes

Concurrency Level: 100
Time taken for tests: 5.517 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 1087000 bytes
HTML transferred: 848000 bytes
Requests per second: 181.27 [#/sec] (mean)
Time per request: 551.660 [ms] (mean)
Time per request: 5.517 [ms] (mean, across all concurrent requests)
Transfer rate: 192.42 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 1 2.0 0 23
Processing: 19 526 97.3 544 672
Waiting: 19 525 97.2 544 672
Total: 19 527 97.6 546 672

Percentage of the requests served within a certain time (ms)
50% 546
66% 559
75% 567
80% 574
90% 594
95% 613
98% 628
99% 644
100% 672 (longest request)
</code>
|
<code>
Document Path: /examples/jsp/jsp2/simpletag/hello.jsp
Document Length: 334 bytes

Concurrency Level: 100
Time taken for tests: 1.068 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 555000 bytes
HTML transferred: 334000 bytes
Requests per second: 936.01 [#/sec] (mean)
Time per request: 106.836 [ms] (mean)
Time per request: 1.068 [ms] (mean, across all concurrent requests)
Transfer rate: 507.31 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.8 0 15
Processing: 5 101 89.4 81 404
Waiting: 2 72 90.6 45 393
Total: 5 101 89.3 81 404

Percentage of the requests served within a certain time (ms)
50% 81
66% 83
75% 84
80% 85
90% 331
95% 356
98% 384
99% 400
100% 404 (longest request)</code>
|
<code>
Document Path: /index.html
Document Length: 332 bytes

Concurrency Level: 100
Time taken for tests: 0.647 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 594000 bytes
HTML transferred: 332000 bytes
Requests per second: 1544.49 [#/sec] (mean)
Time per request: 64.746 [ms] (mean)
Time per request: 0.647 [ms] (mean, across all concurrent requests)
Transfer rate: 895.93 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.4 0 3
Processing: 21 61 10.1 63 84
Waiting: 20 61 10.1 63 84
Total: 21 61 10.1 63 84

Percentage of the requests served within a certain time (ms)
50% 63
66% 63
75% 65
80% 67
90% 71
95% 75
98% 78
99% 79
100% 84 (longest request)
</code>

|}

Xebra Benchmarks

2009-09-01T19:13:38Z

Fabioz: /* Results */

[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

==Environment==
*Windows 7 64Bit
*Xebra revision 80570
*Eiffel Studio 6.5.7.9743 GPL Edition - windows
*Eiffel src revision 80570
*IIS 7.5.7100
*Apache 2.2.11
*ApacheBench 2.3
*Tomcat 6.0

==Settings==
*Using experimental library
*Server and webapps are finalized. Webapp is unmanaged.

The page has the following content:
<code>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 STRICT//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"></meta>
<title>Xebra Hello World Application</title>
</head>
<body>
Hello {print 'WORLD' or 'world' depending on current time}
</body>
</html>
</code>

==Results==

{| class="wikitable"
! Xebra Webapp on Apache
! Xebra Webapp on IIS
! Java JSP Webapp on Tomcat
! Static Page on Apache
|-
|
1000 requests, concurrency level 1
|
|
|-
|
<code>
Document Path: /helloworld/index.xeb
Document Length: 331 bytes

Concurrency Level: 1
Time taken for tests: 9.290 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 716000 bytes
HTML transferred: 331000 bytes
Requests per second: 107.64 [#/sec] (mean)
Time per request: 9.290 [ms] (mean)
Time per request: 9.290 [ms] (mean, across all concurrent requests)
Transfer rate: 75.27 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.3 0 1
Processing: 7 9 1.4 9 21
Waiting: 7 9 1.4 9 21
Total: 7 9 1.4 9 21

Percentage of the requests served within a certain time (ms)
50% 9
66% 10
75% 10
80% 10
90% 11
95% 11
98% 14
99% 16
100% 21 (longest request)
</code>
|
<code>
Document Path: /hellworld/index.xeb
Document Length: 848 bytes

Concurrency Level: 1
Time taken for tests: 9.243 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 1087000 bytes
HTML transferred: 848000 bytes
Requests per second: 108.19 [#/sec] (mean)
Time per request: 9.243 [ms] (mean)
Time per request: 9.243 [ms] (mean, across all concurrent requests)
Transfer rate: 114.84 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.4 0 1
Processing: 7 9 4.0 8 63
Waiting: 7 9 4.0 8 63
Total: 7 9 4.0 8 63

Percentage of the requests served within a certain time (ms)
50% 8
66% 9
75% 9
80% 9
90% 10
95% 13
98% 16
99% 31
100% 63 (longest request)
</code>
|
<code>
Document Path: /examples/jsp/jsp2/simpletag/hello.jsp
Document Length: 334 bytes

Concurrency Level: 1
Time taken for tests: 1.247 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 555000 bytes
HTML transferred: 334000 bytes
Requests per second: 801.88 [#/sec] (mean)
Time per request: 1.247 [ms] (mean)
Time per request: 1.247 [ms] (mean, across all concurrent requests)
Transfer rate: 434.61 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.4 0 1
Processing: 0 1 0.3 1 4
Waiting: 0 1 0.4 1 4
Total: 1 1 0.4 1 5

Percentage of the requests served within a certain time (ms)
50% 1
66% 1
75% 1
80% 1
90% 2
95% 2
98% 2
99% 2
100% 5 (longest request)</code>
|
<code>
Document Path: /index.html
Document Length: 332 bytes

Concurrency Level: 1
Time taken for tests: 0.893 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 594000 bytes
HTML transferred: 332000 bytes
Requests per second: 1120.35 [#/sec] (mean)
Time per request: 0.893 [ms] (mean)
Time per request: 0.893 [ms] (mean, across all concurrent requests)
Transfer rate: 649.89 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.3 0 1
Processing: 0 1 0.6 1 11
Waiting: 0 1 0.6 1 11
Total: 0 1 0.5 1 11

Percentage of the requests served within a certain time (ms)
50% 1
66% 1
75% 1
80% 1
90% 1
95% 1
98% 1
99% 1
100% 11 (longest request)
</code>
|-
|
1000 requests, concurrency level 10
|
|
|-
|
<code>
Document Path: /helloworld/index.xeb
Document Length: 331 bytes

Concurrency Level: 10
Time taken for tests: 8.527 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 716000 bytes
HTML transferred: 331000 bytes
Requests per second: 117.27 [#/sec] (mean)
Time per request: 85.273 [ms] (mean)
Time per request: 8.527 [ms] (mean, across all concurrent requests)
Transfer rate: 82.00 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.4 0 1
Processing: 31 84 10.5 87 107
Waiting: 31 84 10.5 87 107
Total: 31 85 10.5 87 107

Percentage of the requests served within a certain time (ms)
50% 87
66% 90
75% 93
80% 95
90% 98
95% 101
98% 103
99% 104
100% 107 (longest request)
</code>
|
<code>
Document Path: /hellworld/index.xeb
Document Length: 848 bytes

Concurrency Level: 10
Time taken for tests: 5.491 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 1087000 bytes
HTML transferred: 848000 bytes
Requests per second: 182.11 [#/sec] (mean)
Time per request: 54.912 [ms] (mean)
Time per request: 5.491 [ms] (mean, across all concurrent requests)
Transfer rate: 193.31 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 1 1.8 0 27
Processing: 10 54 20.2 49 169
Waiting: 9 53 20.2 49 169
Total: 11 54 20.2 50 169

Percentage of the requests served within a certain time (ms)
50% 50
66% 57
75% 63
80% 67
90% 81
95% 96
98% 111
99% 124
100% 169 (longest request)
</code>
|
<code>
Document Path: /examples/jsp/jsp2/simpletag/hello.jsp
Document Length: 334 bytes

Concurrency Level: 10
Time taken for tests: 0.828 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 555000 bytes
HTML transferred: 334000 bytes
Requests per second: 1207.55 [#/sec] (mean)
Time per request: 8.281 [ms] (mean)
Time per request: 0.828 [ms] (mean, across all concurrent requests)
Transfer rate: 654.48 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.5 0 2
Processing: 1 8 1.6 8 19
Waiting: 0 5 2.4 5 19
Total: 2 8 1.6 8 19

Percentage of the requests served within a certain time (ms)
50% 8
66% 8
75% 9
80% 9
90% 10
95% 12
98% 14
99% 15
100% 19 (longest request)</code>
|
<code>
Document Path: /index.html
Document Length: 332 bytes

Concurrency Level: 10
Time taken for tests: 0.559 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 594000 bytes
HTML transferred: 332000 bytes
Requests per second: 1790.21 [#/sec] (mean)
Time per request: 5.586 [ms] (mean)
Time per request: 0.559 [ms] (mean, across all concurrent requests)
Transfer rate: 1038.46 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.4 0 2
Processing: 1 5 2.9 5 87
Waiting: 1 5 2.9 5 87
Total: 2 5 2.9 5 87

Percentage of the requests served within a certain time (ms)
50% 5
66% 6
75% 6
80% 6
90% 6
95% 7
98% 9
99% 11
100% 87 (longest request)
</code>
|-
|
1000 requests, concurrency level 100
|
|
|-
|
<code>
Document Path: /helloworld/index.xeb
Document Length: 331 bytes

Concurrency Level: 100
Time taken for tests: 8.970 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 716000 bytes
HTML transferred: 331000 bytes
Requests per second: 111.49 [#/sec] (mean)
Time per request: 896.973 [ms] (mean)
Time per request: 8.970 [ms] (mean, across all concurrent requests)
Transfer rate: 77.95 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.4 0 2
Processing: 54 846 175.6 912 1018
Waiting: 54 846 175.6 912 1018
Total: 54 846 175.6 912 1018

Percentage of the requests served within a certain time (ms)
50% 912
66% 929
75% 940
80% 972
90% 994
95% 1002
98% 1014
99% 1016
100% 1018 (longest request)
</code>
|
<code>
Document Path: /hellworld/index.xeb
Document Length: 848 bytes

Concurrency Level: 100
Time taken for tests: 5.517 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 1087000 bytes
HTML transferred: 848000 bytes
Requests per second: 181.27 [#/sec] (mean)
Time per request: 551.660 [ms] (mean)
Time per request: 5.517 [ms] (mean, across all concurrent requests)
Transfer rate: 192.42 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 1 2.0 0 23
Processing: 19 526 97.3 544 672
Waiting: 19 525 97.2 544 672
Total: 19 527 97.6 546 672

Percentage of the requests served within a certain time (ms)
50% 546
66% 559
75% 567
80% 574
90% 594
95% 613
98% 628
99% 644
100% 672 (longest request)
</code>
|
<code>
Document Path: /examples/jsp/jsp2/simpletag/hello.jsp
Document Length: 334 bytes

Concurrency Level: 100
Time taken for tests: 1.068 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 555000 bytes
HTML transferred: 334000 bytes
Requests per second: 936.01 [#/sec] (mean)
Time per request: 106.836 [ms] (mean)
Time per request: 1.068 [ms] (mean, across all concurrent requests)
Transfer rate: 507.31 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.8 0 15
Processing: 5 101 89.4 81 404
Waiting: 2 72 90.6 45 393
Total: 5 101 89.3 81 404

Percentage of the requests served within a certain time (ms)
50% 81
66% 83
75% 84
80% 85
90% 331
95% 356
98% 384
99% 400
100% 404 (longest request)</code>
|
<code>
Document Path: /index.html
Document Length: 332 bytes

Concurrency Level: 100
Time taken for tests: 0.647 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 594000 bytes
HTML transferred: 332000 bytes
Requests per second: 1544.49 [#/sec] (mean)
Time per request: 64.746 [ms] (mean)
Time per request: 0.647 [ms] (mean, across all concurrent requests)
Transfer rate: 895.93 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.4 0 3
Processing: 21 61 10.1 63 84
Waiting: 20 61 10.1 63 84
Total: 21 61 10.1 63 84

Percentage of the requests served within a certain time (ms)
50% 63
66% 63
75% 65
80% 67
90% 71
95% 75
98% 78
99% 79
100% 84 (longest request)
</code>

|}

Xebra Benchmarks

2009-09-01T19:10:20Z

Fabioz: /* Environment */

[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

==Environment==
*Windows 7 64Bit
*Xebra revision 80570
*Eiffel Studio 6.5.7.9743 GPL Edition - windows
*Eiffel src revision 80570
*IIS 7.5.7100
*Apache 2.2.11
*ApacheBench 2.3
*Tomcat 6.0

==Settings==
*Using experimental library
*Server and webapps are finalized. Webapp is unmanaged.

The page has the following content:
<code>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 STRICT//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"></meta>
<title>Xebra Hello World Application</title>
</head>
<body>
Hello {print 'WORLD' or 'world' depending on current time}
</body>
</html>
</code>

==Results==

{| class="wikitable"
! Xebra Webapp on Apache
! Xebra Webapp on IIS
! Java JSP Webapp on Tomcat
! Static Page on Apache
|-
|
1000 requests, concurrency level 1
|
|
|-
|
<code>
Document Path: /helloworld/index.xeb
Document Length: 331 bytes

Concurrency Level: 1
Time taken for tests: 9.290 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 716000 bytes
HTML transferred: 331000 bytes
Requests per second: 107.64 [#/sec] (mean)
Time per request: 9.290 [ms] (mean)
Time per request: 9.290 [ms] (mean, across all concurrent requests)
Transfer rate: 75.27 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.3 0 1
Processing: 7 9 1.4 9 21
Waiting: 7 9 1.4 9 21
Total: 7 9 1.4 9 21

Percentage of the requests served within a certain time (ms)
50% 9
66% 10
75% 10
80% 10
90% 11
95% 11
98% 14
99% 16
100% 21 (longest request)
</code>
|
<code>
Document Path: /hellworld/index.xeb
Document Length: 848 bytes

Concurrency Level: 1
Time taken for tests: 9.243 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 1087000 bytes
HTML transferred: 848000 bytes
Requests per second: 108.19 [#/sec] (mean)
Time per request: 9.243 [ms] (mean)
Time per request: 9.243 [ms] (mean, across all concurrent requests)
Transfer rate: 114.84 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.4 0 1
Processing: 7 9 4.0 8 63
Waiting: 7 9 4.0 8 63
Total: 7 9 4.0 8 63

Percentage of the requests served within a certain time (ms)
50% 8
66% 9
75% 9
80% 9
90% 10
95% 13
98% 16
99% 31
100% 63 (longest request)
</code>
|
<code>
tomcat
</code>
|
<code>
Document Path: /index.html
Document Length: 332 bytes

Concurrency Level: 1
Time taken for tests: 0.893 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 594000 bytes
HTML transferred: 332000 bytes
Requests per second: 1120.35 [#/sec] (mean)
Time per request: 0.893 [ms] (mean)
Time per request: 0.893 [ms] (mean, across all concurrent requests)
Transfer rate: 649.89 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.3 0 1
Processing: 0 1 0.6 1 11
Waiting: 0 1 0.6 1 11
Total: 0 1 0.5 1 11

Percentage of the requests served within a certain time (ms)
50% 1
66% 1
75% 1
80% 1
90% 1
95% 1
98% 1
99% 1
100% 11 (longest request)
</code>
|-
|
1000 requests, concurrency level 10
|
|
|-
|
<code>
Document Path: /helloworld/index.xeb
Document Length: 331 bytes

Concurrency Level: 10
Time taken for tests: 8.527 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 716000 bytes
HTML transferred: 331000 bytes
Requests per second: 117.27 [#/sec] (mean)
Time per request: 85.273 [ms] (mean)
Time per request: 8.527 [ms] (mean, across all concurrent requests)
Transfer rate: 82.00 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.4 0 1
Processing: 31 84 10.5 87 107
Waiting: 31 84 10.5 87 107
Total: 31 85 10.5 87 107

Percentage of the requests served within a certain time (ms)
50% 87
66% 90
75% 93
80% 95
90% 98
95% 101
98% 103
99% 104
100% 107 (longest request)
</code>
|
<code>
Document Path: /hellworld/index.xeb
Document Length: 848 bytes

Concurrency Level: 10
Time taken for tests: 5.491 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 1087000 bytes
HTML transferred: 848000 bytes
Requests per second: 182.11 [#/sec] (mean)
Time per request: 54.912 [ms] (mean)
Time per request: 5.491 [ms] (mean, across all concurrent requests)
Transfer rate: 193.31 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 1 1.8 0 27
Processing: 10 54 20.2 49 169
Waiting: 9 53 20.2 49 169
Total: 11 54 20.2 50 169

Percentage of the requests served within a certain time (ms)
50% 50
66% 57
75% 63
80% 67
90% 81
95% 96
98% 111
99% 124
100% 169 (longest request)
</code>
|
<code>
tomcat
</code>
|
<code>
Document Path: /index.html
Document Length: 332 bytes

Concurrency Level: 10
Time taken for tests: 0.559 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 594000 bytes
HTML transferred: 332000 bytes
Requests per second: 1790.21 [#/sec] (mean)
Time per request: 5.586 [ms] (mean)
Time per request: 0.559 [ms] (mean, across all concurrent requests)
Transfer rate: 1038.46 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.4 0 2
Processing: 1 5 2.9 5 87
Waiting: 1 5 2.9 5 87
Total: 2 5 2.9 5 87

Percentage of the requests served within a certain time (ms)
50% 5
66% 6
75% 6
80% 6
90% 6
95% 7
98% 9
99% 11
100% 87 (longest request)
</code>
|-
|
1000 requests, concurrency level 100
|
|
|-
|
<code>
Document Path: /helloworld/index.xeb
Document Length: 331 bytes

Concurrency Level: 100
Time taken for tests: 8.970 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 716000 bytes
HTML transferred: 331000 bytes
Requests per second: 111.49 [#/sec] (mean)
Time per request: 896.973 [ms] (mean)
Time per request: 8.970 [ms] (mean, across all concurrent requests)
Transfer rate: 77.95 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.4 0 2
Processing: 54 846 175.6 912 1018
Waiting: 54 846 175.6 912 1018
Total: 54 846 175.6 912 1018

Percentage of the requests served within a certain time (ms)
50% 912
66% 929
75% 940
80% 972
90% 994
95% 1002
98% 1014
99% 1016
100% 1018 (longest request)
</code>
|
<code>
Document Path: /hellworld/index.xeb
Document Length: 848 bytes

Concurrency Level: 100
Time taken for tests: 5.517 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 1087000 bytes
HTML transferred: 848000 bytes
Requests per second: 181.27 [#/sec] (mean)
Time per request: 551.660 [ms] (mean)
Time per request: 5.517 [ms] (mean, across all concurrent requests)
Transfer rate: 192.42 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 1 2.0 0 23
Processing: 19 526 97.3 544 672
Waiting: 19 525 97.2 544 672
Total: 19 527 97.6 546 672

Percentage of the requests served within a certain time (ms)
50% 546
66% 559
75% 567
80% 574
90% 594
95% 613
98% 628
99% 644
100% 672 (longest request)
</code>
|
<code>
tomcat
</code>
|
<code>
Document Path: /index.html
Document Length: 332 bytes

Concurrency Level: 100
Time taken for tests: 0.647 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 594000 bytes
HTML transferred: 332000 bytes
Requests per second: 1544.49 [#/sec] (mean)
Time per request: 64.746 [ms] (mean)
Time per request: 0.647 [ms] (mean, across all concurrent requests)
Transfer rate: 895.93 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.4 0 3
Processing: 21 61 10.1 63 84
Waiting: 20 61 10.1 63 84
Total: 21 61 10.1 63 84

Percentage of the requests served within a certain time (ms)
50% 63
66% 63
75% 65
80% 67
90% 71
95% 75
98% 78
99% 79
100% 84 (longest request)
</code>

|}

Xebra Benchmarks

2009-09-01T18:55:53Z

Fabioz: /* Results */

[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

==Environment==
*Windows 7 64Bit
*Xebra revision 80570
*Eiffel Studio 6.5.7.9743 GPL Edition - windows
*Eiffel src revision 80570
*IIS 7.5.7100
*Apache 2.2.11
*ApacheBench 2.3

==Settings==
*Using experimental library
*Server and webapps are finalized. Webapp is unmanaged.

The page has the following content:
<code>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 STRICT//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"></meta>
<title>Xebra Hello World Application</title>
</head>
<body>
Hello {print 'WORLD' or 'world' depending on current time}
</body>
</html>
</code>

==Results==

{| class="wikitable"
! Xebra Webapp on Apache
! Xebra Webapp on IIS
! Java JSP Webapp on Tomcat
! Static Page on Apache
|-
|
1000 requests, concurrency level 1
|
|
|-
|
<code>
Document Path: /helloworld/index.xeb
Document Length: 331 bytes

Concurrency Level: 1
Time taken for tests: 9.290 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 716000 bytes
HTML transferred: 331000 bytes
Requests per second: 107.64 [#/sec] (mean)
Time per request: 9.290 [ms] (mean)
Time per request: 9.290 [ms] (mean, across all concurrent requests)
Transfer rate: 75.27 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.3 0 1
Processing: 7 9 1.4 9 21
Waiting: 7 9 1.4 9 21
Total: 7 9 1.4 9 21

Percentage of the requests served within a certain time (ms)
50% 9
66% 10
75% 10
80% 10
90% 11
95% 11
98% 14
99% 16
100% 21 (longest request)
</code>
|
<code>
Document Path: /hellworld/index.xeb
Document Length: 848 bytes

Concurrency Level: 1
Time taken for tests: 9.243 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 1087000 bytes
HTML transferred: 848000 bytes
Requests per second: 108.19 [#/sec] (mean)
Time per request: 9.243 [ms] (mean)
Time per request: 9.243 [ms] (mean, across all concurrent requests)
Transfer rate: 114.84 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.4 0 1
Processing: 7 9 4.0 8 63
Waiting: 7 9 4.0 8 63
Total: 7 9 4.0 8 63

Percentage of the requests served within a certain time (ms)
50% 8
66% 9
75% 9
80% 9
90% 10
95% 13
98% 16
99% 31
100% 63 (longest request)
</code>
|
<code>
tomcat
</code>
|
<code>
Document Path: /index.html
Document Length: 332 bytes

Concurrency Level: 1
Time taken for tests: 0.893 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 594000 bytes
HTML transferred: 332000 bytes
Requests per second: 1120.35 [#/sec] (mean)
Time per request: 0.893 [ms] (mean)
Time per request: 0.893 [ms] (mean, across all concurrent requests)
Transfer rate: 649.89 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.3 0 1
Processing: 0 1 0.6 1 11
Waiting: 0 1 0.6 1 11
Total: 0 1 0.5 1 11

Percentage of the requests served within a certain time (ms)
50% 1
66% 1
75% 1
80% 1
90% 1
95% 1
98% 1
99% 1
100% 11 (longest request)
</code>
|-
|
1000 requests, concurrency level 10
|
|
|-
|
<code>
Document Path: /helloworld/index.xeb
Document Length: 331 bytes

Concurrency Level: 10
Time taken for tests: 8.527 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 716000 bytes
HTML transferred: 331000 bytes
Requests per second: 117.27 [#/sec] (mean)
Time per request: 85.273 [ms] (mean)
Time per request: 8.527 [ms] (mean, across all concurrent requests)
Transfer rate: 82.00 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.4 0 1
Processing: 31 84 10.5 87 107
Waiting: 31 84 10.5 87 107
Total: 31 85 10.5 87 107

Percentage of the requests served within a certain time (ms)
50% 87
66% 90
75% 93
80% 95
90% 98
95% 101
98% 103
99% 104
100% 107 (longest request)
</code>
|
<code>
Document Path: /hellworld/index.xeb
Document Length: 848 bytes

Concurrency Level: 10
Time taken for tests: 5.491 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 1087000 bytes
HTML transferred: 848000 bytes
Requests per second: 182.11 [#/sec] (mean)
Time per request: 54.912 [ms] (mean)
Time per request: 5.491 [ms] (mean, across all concurrent requests)
Transfer rate: 193.31 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 1 1.8 0 27
Processing: 10 54 20.2 49 169
Waiting: 9 53 20.2 49 169
Total: 11 54 20.2 50 169

Percentage of the requests served within a certain time (ms)
50% 50
66% 57
75% 63
80% 67
90% 81
95% 96
98% 111
99% 124
100% 169 (longest request)
</code>
|
<code>
tomcat
</code>
|
<code>
Document Path: /index.html
Document Length: 332 bytes

Concurrency Level: 10
Time taken for tests: 0.559 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 594000 bytes
HTML transferred: 332000 bytes
Requests per second: 1790.21 [#/sec] (mean)
Time per request: 5.586 [ms] (mean)
Time per request: 0.559 [ms] (mean, across all concurrent requests)
Transfer rate: 1038.46 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.4 0 2
Processing: 1 5 2.9 5 87
Waiting: 1 5 2.9 5 87
Total: 2 5 2.9 5 87

Percentage of the requests served within a certain time (ms)
50% 5
66% 6
75% 6
80% 6
90% 6
95% 7
98% 9
99% 11
100% 87 (longest request)
</code>
|-
|
1000 requests, concurrency level 100
|
|
|-
|
<code>
Document Path: /helloworld/index.xeb
Document Length: 331 bytes

Concurrency Level: 100
Time taken for tests: 8.970 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 716000 bytes
HTML transferred: 331000 bytes
Requests per second: 111.49 [#/sec] (mean)
Time per request: 896.973 [ms] (mean)
Time per request: 8.970 [ms] (mean, across all concurrent requests)
Transfer rate: 77.95 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.4 0 2
Processing: 54 846 175.6 912 1018
Waiting: 54 846 175.6 912 1018
Total: 54 846 175.6 912 1018

Percentage of the requests served within a certain time (ms)
50% 912
66% 929
75% 940
80% 972
90% 994
95% 1002
98% 1014
99% 1016
100% 1018 (longest request)
</code>
|
<code>
Document Path: /hellworld/index.xeb
Document Length: 848 bytes

Concurrency Level: 100
Time taken for tests: 5.517 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 1087000 bytes
HTML transferred: 848000 bytes
Requests per second: 181.27 [#/sec] (mean)
Time per request: 551.660 [ms] (mean)
Time per request: 5.517 [ms] (mean, across all concurrent requests)
Transfer rate: 192.42 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 1 2.0 0 23
Processing: 19 526 97.3 544 672
Waiting: 19 525 97.2 544 672
Total: 19 527 97.6 546 672

Percentage of the requests served within a certain time (ms)
50% 546
66% 559
75% 567
80% 574
90% 594
95% 613
98% 628
99% 644
100% 672 (longest request)
</code>
|
<code>
tomcat
</code>
|
<code>
Document Path: /index.html
Document Length: 332 bytes

Concurrency Level: 100
Time taken for tests: 0.647 seconds
Complete requests: 1000
Failed requests: 0
Write errors: 0
Total transferred: 594000 bytes
HTML transferred: 332000 bytes
Requests per second: 1544.49 [#/sec] (mean)
Time per request: 64.746 [ms] (mean)
Time per request: 0.647 [ms] (mean, across all concurrent requests)
Transfer rate: 895.93 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 0 0.4 0 3
Processing: 21 61 10.1 63 84
Waiting: 20 61 10.1 63 84
Total: 21 61 10.1 63 84

Percentage of the requests served within a certain time (ms)
50% 63
66% 63
75% 65
80% 67
90% 71
95% 75
98% 78
99% 79
100% 84 (longest request)
</code>

|}

Xebra Benchmarks

2009-09-01T18:53:24Z

Fabioz: /* Environment */

Xebra Benchmarks

2009-09-01T18:49:42Z

Fabioz: /* Results */

Xebra Benchmarks

2009-09-01T18:48:51Z

Fabioz: /* Results */

Xebra Benchmarks

2009-09-01T18:46:02Z

Fabioz: /* Results */

Xebra Benchmarks

2009-09-01T18:44:39Z

Fabioz:

Xebra Benchmarks

2009-09-01T17:46:25Z

Fabioz: /* Results */

Xebra Benchmarks

2009-09-01T17:39:50Z

Fabioz:

Xebra Benchmarks

2009-09-01T17:36:50Z

Fabioz: /* Environment */

==Environment==
*Ubuntu 9.04 64Bit
*Xebra revision 80570
*Eiffel Studio 6.5.8.524 GPL Edition - linux-x86
*Eiffel src revision 80570
*Apache 2.2.13

==Settings==
*Using experimental library
*Server and webapps are finalized. Webapp is unmanaged.

The page has the following content:
<code>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 STRICT//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"></meta>
<title>Xebra Hello World Application</title>
</head>
<body>
Hello {print 'WORLD' or 'world' depending on current time}
</body>
</html>
</code>

==Results==

Xebra Benchmarks

2009-09-01T17:27:27Z

Fabioz:

==Environment==
*Ubuntu 9.04 64Bit
*Xebra revision 80570
*Eiffel Studio 6.5.8.524 GPL Edition - linux-x86
*Eiffel src revision 80570

==Settings==
*Using experimental library
*Server and webapps are finalized. Webapp is unmanaged.

The page has the following content:
<code>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 STRICT//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"></meta>
<title>Xebra Hello World Application</title>
</head>
<body>
Hello {print 'WORLD' or 'world' depending on current time}
</body>
</html>
</code>

==Results==

Xebra Benchmarks

2009-09-01T17:26:08Z

Fabioz: New page: Ubuntu 9.04 64Bit Xebra revision 80570 Eiffel Studio 6.5.8.524 GPL Edition - linux-x86 Eiffel src revision 80570 Using experimental library Server and webapps are finalized. Webapp is un...

Ubuntu 9.04 64Bit
Xebra revision 80570
Eiffel Studio 6.5.8.524 GPL Edition - linux-x86
Eiffel src revision 80570
Using experimental library

Server and webapps are finalized. Webapp is unmanaged.

Xebra Documentation

2009-09-01T17:02:32Z

Fabioz:

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

=Overview=
* [[Xebra Socket Communication]]

=Xebra HTTP Server Plugins=
* [[Xebra Module Communication Protocol|Module Communication Protocol]]
* [[Xebra Module Content Types|Content Types]]

==Mod_xebra for Apache==
* [[Xebra Apache Module Windows|Apache Module Windows]]

=Xebra Server=
* [[Xebra Server Administration]]

= Web Applications =
* [[Xebra Webapp Config File]]

==Xebra Tag Libraries==
On the following pages you can find the descriptions of the different tags of the available tag libraries.
* [[Xebra Taglib Page|Page]]
* [[Xebra Taglib Xeb|Xeb]]
* [[Xebra Taglib Form|Form]]
* [[Xebra Taglib XRPC|XRPC]]
* [[Xebra Tag Attribute|Tag Attribute]]

==Master pages==
* [[Xebra Master Pages|Templates with master pages]]

==XML_RPC==
* [[Xebra XML_RPC]]

=Code documentation=
==Xebra Libraries==
=== Thread Utilities ===
An implementation of a [http://en.wikipedia.org/wiki/Thread_pool_pattern| Thread Pool]. There are two implementations: with or without data class reuse (DATA_THREAD_POOL and THREAD_POOL).

=== Xebra AST Elements ===
This library contains various classes which model eiffel language constructs. It consists of classes, features, comments, locals and expressions. They can be combined to build an object model of an eiffel class. Convenience features are provided to add locals and variables with unique names.
AST Elements can be serialized to a text representation.
It also contains some specialized classes for Xebra.

=== Xebra Common ===

Xebra_common contains all commands, command responses and interfaces for commands that are used by the server and the webapps. Furthermore, it contains deferred classes for server modules and webapp config classes.

=== Xebra Error===
Provides internal error types for all xebra applications such as XERROR_CANNOT_OPEN_FILE or XERROR_SOCKET_NOT_BOUND. These errors are not supplied to the browser but only displayed in the log/console.

=== Xebra Error Responses ===
Classes from xebra_error_responses are split into XER_SERVER: error responses generated by the server and XER_APP: error responses generated by the webapp. Both types are ultimately sent to the http server plugin and displayed in the user's browser. For instance XER_POST_TOO_BIG is a server error response that is created if the post request is bigger than allowed. XER_APP_CANNOT_FIND_PAGE is a response created by the webapp and then sent to the server if no servlet with the specified name was defined.

=== Xebra Http ===

Xebra_http provides classes for cookies, html requests, html responses, sessions and their parsers.

=== Xebra Taglibrary Base ===
The base tag library contains all the basic Xebra tag implementations like display, call and iterate. For a more detailed explanation of the tags see [[Xebra_Taglib_Xeb| the documentation]].

=== Xebra Taglibrary Form ===
The form tag library contains all tag implementations for form related tags. Automatic wrapping of values, controls and validations are included in this library. For a more detailed explanation see [[Xebra_Taglib_Form|here]].

=== Xebra Taglibrary XRPC ===
This tag library contains tags for XML-RPC applications. For further information see [[Xebra_Taglib_XRPC|here]].

=== Xebra Utilities ===

Xebra_utilities is a collection of independent helper classes such as text escaper, file utilities, log outputter, stopwatch, string expander etc.

=== Xebra Tags ===
Contains all super classes used for xebra tags and xebra tag arguments. Also contains super classes for servlet generation (XGEN_SERVLET_GENERATOR).

===Xebra Web Application===

Provides all necessary base classes such as XWA_SERVLET, XWA_CONTROLLER, XWA_APPLICATION to webapp applications. Takes care of communication with server.

= Other =
* [[Xebra Benchmarks|Benchmarks]]

== Howtos ==
===Build Windows Installer===

* Install apache (c:\apache)
*Visual Build Professional 7:
**Open xebra\tools\installer\win\XebraBuild.bld
**Adapt Macro->Project variables to match your system (APACHE, ROOT)
**Run
*Inno Setup 5 Compiler
**Open xebra\tools\installer\win\innosetup\xebra_install_test.iss
**Generate new AppId
**Changed AppVersion
**Check that LicenseFile file exists (gnu licence?)
**Check Source files are correct folder
**Build

Xebra Issues

2009-09-01T16:48:19Z

Fabioz: /* Other */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

The following list represents the improvements which should be implemented in further releases but which are yet missing.

=== Xebra Translator ===

* Allow parameters for calls in xeb files. As for now it is only possible to use predefined variables (multiple allowed). The new implementation would allow manifest strings, integers and all the other primitive types to be added. For this purpose the grammar has to be modified and probably some model classes.
* Make sure that all the variable names used don't conflict with other names (unless the user used them twice).
* Allow injected #{} and %=% into attributes, replacing the functionality of xeb:concat. In a bigger step the grammar for attributes could be expanded to allow Eiffel expressions.
* Establish common names and change tags accordingly if they don't conform. An example is 'type' which should be used instead of 'class'.
* Multi-threaded translation

=== Xebra Server ===
* Implement multithreaded request processing

=== Webapps ===
* The problem with uploading certain files seems to persist
* Allow in .wapp relative path for the ecf
* Implement multithreaded request processing

=== HTTP Server Plugins ===

* Automatically launch xebra server

=== Other ===
* Fix memory leak in socket.accept on timeout (DEVELOPER_EXCEPTION)
* Implement i18n support
* Implement caching
* Add support for unicode

Xebra Issues

2009-09-01T16:13:36Z

Fabioz: /* Webapps */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

The following list represents the improvements which should be implemented in further releases but which are yet missing.

=== Xebra Translator ===

* Allow parameters for calls in xeb files. As for now it is only possible to use predefined variables (multiple allowed). The new implementation would allow manifest strings, integers and all the other primitive types to be added. For this purpose the grammar has to be modified and probably some model classes.
* Make sure that all the variable names used don't conflict with other names (unless the user used them twice).
* Allow injected #{} and %=% into attributes, replacing the functionality of xeb:concat. In a bigger step the grammar for attributes could be expanded to allow Eiffel expressions.
* Establish common names and change tags accordingly if they don't conform. An example is 'type' which should be used instead of 'class'.
* Multi-threaded translation

=== Xebra Server ===
* Implement multithreaded request processing

=== Webapps ===
* The problem with uploading certain files seems to persist
* Allow in .wapp relative path for the ecf
* Implement multithreaded request processing

=== HTTP Server Plugins ===

* Automatically launch xebra server

=== Other ===
* Fix memory leak in socket.accept
* Implement i18n support
* Implement caching
* Add support for unicode

Xebra Issues

2009-09-01T16:12:59Z

Fabioz: /* Other */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

The following list represents the improvements which should be implemented in further releases but which are yet missing.

=== Xebra Translator ===

* Allow parameters for calls in xeb files. As for now it is only possible to use predefined variables (multiple allowed). The new implementation would allow manifest strings, integers and all the other primitive types to be added. For this purpose the grammar has to be modified and probably some model classes.
* Make sure that all the variable names used don't conflict with other names (unless the user used them twice).
* Allow injected #{} and %=% into attributes, replacing the functionality of xeb:concat. In a bigger step the grammar for attributes could be expanded to allow Eiffel expressions.
* Establish common names and change tags accordingly if they don't conform. An example is 'type' which should be used instead of 'class'.
* Multi-threaded translation

=== Xebra Server ===
* Implement multithreaded request processing

=== Webapps ===
* Implement multithreaded request processing
* The problem with uploading certain files seems to persist

=== HTTP Server Plugins ===

* Automatically launch xebra server

=== Other ===
* Fix memory leak in socket.accept
* Implement i18n support
* Implement caching
* Add support for unicode

Xebra Issues

2009-09-01T16:12:24Z

Fabioz: /* Webapps */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

The following list represents the improvements which should be implemented in further releases but which are yet missing.

=== Xebra Translator ===

* Allow parameters for calls in xeb files. As for now it is only possible to use predefined variables (multiple allowed). The new implementation would allow manifest strings, integers and all the other primitive types to be added. For this purpose the grammar has to be modified and probably some model classes.
* Make sure that all the variable names used don't conflict with other names (unless the user used them twice).
* Allow injected #{} and %=% into attributes, replacing the functionality of xeb:concat. In a bigger step the grammar for attributes could be expanded to allow Eiffel expressions.
* Establish common names and change tags accordingly if they don't conform. An example is 'type' which should be used instead of 'class'.
* Multi-threaded translation

=== Xebra Server ===
* Implement multithreaded request processing

=== Webapps ===
* Implement multithreaded request processing
* The problem with uploading certain files seems to persist

=== HTTP Server Plugins ===

* Automatically launch xebra server

=== Other ===
* Fix memory leak in socket.accept
* Implement i18n support
* Implement chaching
* Add support for unicode

Xebra Issues

2009-09-01T16:11:45Z

Fabioz: /* HTTP Server Plugins */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

The following list represents the improvements which should be implemented in further releases but which are yet missing.

=== Xebra Translator ===

* Allow parameters for calls in xeb files. As for now it is only possible to use predefined variables (multiple allowed). The new implementation would allow manifest strings, integers and all the other primitive types to be added. For this purpose the grammar has to be modified and probably some model classes.
* Make sure that all the variable names used don't conflict with other names (unless the user used them twice).
* Allow injected #{} and %=% into attributes, replacing the functionality of xeb:concat. In a bigger step the grammar for attributes could be expanded to allow Eiffel expressions.
* Establish common names and change tags accordingly if they don't conform. An example is 'type' which should be used instead of 'class'.
* Multi-threaded translation

=== Xebra Server ===
* Implement multithreaded request processing

=== Webapps ===
* Implement multithreaded request processing

=== HTTP Server Plugins ===

* Automatically launch xebra server

=== Other ===
* Fix memory leak in socket.accept
* Implement i18n support
* Implement chaching
* Add support for unicode

Xebra Issues

2009-09-01T16:11:24Z

Fabioz:

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

The following list represents the improvements which should be implemented in further releases but which are yet missing.

=== Xebra Translator ===

# Allow parameters for calls in xeb files. As for now it is only possible to use predefined variables (multiple allowed). The new implementation would allow manifest strings, integers and all the other primitive types to be added. For this purpose the grammar has to be modified and probably some model classes.
# Make sure that all the variable names used don't conflict with other names (unless the user used them twice).
# Allow injected #{} and %=% into attributes, replacing the functionality of xeb:concat. In a bigger step the grammar for attributes could be expanded to allow Eiffel expressions.
# Establish common names and change tags accordingly if they don't conform. An example is 'type' which should be used instead of 'class'.
# Multi-threaded translation

=== Xebra Server ===
* Implement multithreaded request processing

=== Webapps ===
* Implement multithreaded request processing

=== HTTP Server Plugins ===

=== Other ===
* Fix memory leak in socket.accept
* Implement i18n support
* Implement chaching
* Add support for unicode

Xebra Issues

2009-09-01T16:10:23Z

Fabioz: /* Webapps */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

The following list represents the improvements which should be implemented in further releases but which are yet missing.

=== Xebra Translator ===

# Allow parameters for calls in xeb files. As for now it is only possible to use predefined variables (multiple allowed). The new implementation would allow manifest strings, integers and all the other primitive types to be added. For this purpose the grammar has to be modified and probably some model classes.
# Make sure that all the variable names used don't conflict with other names (unless the user used them twice).
# Allow injected #{} and %=% into attributes, replacing the functionality of xeb:concat. In a bigger step the grammar for attributes could be expanded to allow Eiffel expressions.
# Establish common names and change tags accordingly if they don't conform. An example is 'type' which should be used instead of 'class'.
# Multi-threaded translation

=== Xebra Server ===
* Implement multithreaded request processing

=== Webapps ===
* Implement multithreaded request processing

=== Other ===
* Fix memory leak in socket.accept
* Implement i18n support
* Implement chaching
* Add support for unicode

Xebra Issues

2009-09-01T16:10:12Z

Fabioz: /* Xebra Server */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

The following list represents the improvements which should be implemented in further releases but which are yet missing.

=== Xebra Translator ===

# Allow parameters for calls in xeb files. As for now it is only possible to use predefined variables (multiple allowed). The new implementation would allow manifest strings, integers and all the other primitive types to be added. For this purpose the grammar has to be modified and probably some model classes.
# Make sure that all the variable names used don't conflict with other names (unless the user used them twice).
# Allow injected #{} and %=% into attributes, replacing the functionality of xeb:concat. In a bigger step the grammar for attributes could be expanded to allow Eiffel expressions.
# Establish common names and change tags accordingly if they don't conform. An example is 'type' which should be used instead of 'class'.
# Multi-threaded translation

=== Xebra Server ===
* Implement multithreaded request processing

=== Webapps ===
* Multithreaded request processing

=== Other ===
* Fix memory leak in socket.accept
* Implement i18n support
* Implement chaching
* Add support for unicode

Xebra Issues

2009-09-01T16:09:54Z

Fabioz: /* Other */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

The following list represents the improvements which should be implemented in further releases but which are yet missing.

=== Xebra Translator ===

# Allow parameters for calls in xeb files. As for now it is only possible to use predefined variables (multiple allowed). The new implementation would allow manifest strings, integers and all the other primitive types to be added. For this purpose the grammar has to be modified and probably some model classes.
# Make sure that all the variable names used don't conflict with other names (unless the user used them twice).
# Allow injected #{} and %=% into attributes, replacing the functionality of xeb:concat. In a bigger step the grammar for attributes could be expanded to allow Eiffel expressions.
# Establish common names and change tags accordingly if they don't conform. An example is 'type' which should be used instead of 'class'.
# Multi-threaded translation

=== Xebra Server ===
* Multithreaded request processing

=== Webapps ===
* Multithreaded request processing

=== Other ===
* Fix memory leak in socket.accept
* Implement i18n support
* Implement chaching
* Add support for unicode

Xebra Issues

2009-09-01T16:09:15Z

Fabioz: /* Other */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

The following list represents the improvements which should be implemented in further releases but which are yet missing.

=== Xebra Translator ===

# Allow parameters for calls in xeb files. As for now it is only possible to use predefined variables (multiple allowed). The new implementation would allow manifest strings, integers and all the other primitive types to be added. For this purpose the grammar has to be modified and probably some model classes.
# Make sure that all the variable names used don't conflict with other names (unless the user used them twice).
# Allow injected #{} and %=% into attributes, replacing the functionality of xeb:concat. In a bigger step the grammar for attributes could be expanded to allow Eiffel expressions.
# Establish common names and change tags accordingly if they don't conform. An example is 'type' which should be used instead of 'class'.
# Multi-threaded translation

=== Xebra Server ===
* Multithreaded request processing

=== Webapps ===
* Multithreaded request processing

=== Other ===
* Fix memory leak in socket.accept
* I18n support
* Chaching

Xebra Issues

2009-09-01T16:08:57Z

Fabioz: /* Other */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

The following list represents the improvements which should be implemented in further releases but which are yet missing.

=== Xebra Translator ===

# Allow parameters for calls in xeb files. As for now it is only possible to use predefined variables (multiple allowed). The new implementation would allow manifest strings, integers and all the other primitive types to be added. For this purpose the grammar has to be modified and probably some model classes.
# Make sure that all the variable names used don't conflict with other names (unless the user used them twice).
# Allow injected #{} and %=% into attributes, replacing the functionality of xeb:concat. In a bigger step the grammar for attributes could be expanded to allow Eiffel expressions.
# Establish common names and change tags accordingly if they don't conform. An example is 'type' which should be used instead of 'class'.
# Multi-threaded translation

=== Xebra Server ===
* Multithreaded request processing

=== Webapps ===
* Multithreaded request processing

=== Other ===
* Fix the memoryleak in socket.accept
* I18n support
* Chaching

Xebra Issues

2009-09-01T16:07:32Z

Fabioz:

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

The following list represents the improvements which should be implemented in further releases but which are yet missing.

=== Xebra Translator ===

# Allow parameters for calls in xeb files. As for now it is only possible to use predefined variables (multiple allowed). The new implementation would allow manifest strings, integers and all the other primitive types to be added. For this purpose the grammar has to be modified and probably some model classes.
# Make sure that all the variable names used don't conflict with other names (unless the user used them twice).
# Allow injected #{} and %=% into attributes, replacing the functionality of xeb:concat. In a bigger step the grammar for attributes could be expanded to allow Eiffel expressions.
# Establish common names and change tags accordingly if they don't conform. An example is 'type' which should be used instead of 'class'.

=== Xebra Server ===
* Multithreaded request processing

=== Webapps ===
* Multithreaded request processing

=== Other ===
* I18n support
* Chaching

Xebra Issues

2009-09-01T16:06:57Z

Fabioz: /* Other */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

The following list represents the improvements which should be implemented in further releases but which are yet missing.

=== Xebra Translator ===

# Allow parameters for calls in xeb files. As for now it is only possible to use predefined variables (multiple allowed). The new implementation would allow manifest strings, integers and all the other primitive types to be added. For this purpose the grammar has to be modified and probably some model classes.
# Make sure that all the variable names used don't conflict with other names (unless the user used them twice).
# Allow injected #{} and %=% into attributes, replacing the functionality of xeb:concat. In a bigger step the grammar for attributes could be expanded to allow Eiffel expressions.
# Establish common names and change tags accordingly if they don't conform. An example is 'type' which should be used instead of 'class'.

=== Xebra Server ===
* Multithreaded request processing

=== Other ===
* Implement i18n support
* Implement chaching

Xebra Issues

2009-09-01T16:05:19Z

Fabioz: /* Other */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

The following list represents the improvements which should be implemented in further releases but which are yet missing.

=== Xebra Translator ===

# Allow parameters for calls in xeb files. As for now it is only possible to use predefined variables (multiple allowed). The new implementation would allow manifest strings, integers and all the other primitive types to be added. For this purpose the grammar has to be modified and probably some model classes.
# Make sure that all the variable names used don't conflict with other names (unless the user used them twice).
# Allow injected #{} and %=% into attributes, replacing the functionality of xeb:concat. In a bigger step the grammar for attributes could be expanded to allow Eiffel expressions.
# Establish common names and change tags accordingly if they don't conform. An example is 'type' which should be used instead of 'class'.

=== Xebra Server ===
* Multithreaded request processing

=== Other ===
* Implement i18n support

Xebra Issues

2009-09-01T16:04:57Z

Fabioz: /* Xebra Server */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

The following list represents the improvements which should be implemented in further releases but which are yet missing.

=== Xebra Translator ===

# Allow parameters for calls in xeb files. As for now it is only possible to use predefined variables (multiple allowed). The new implementation would allow manifest strings, integers and all the other primitive types to be added. For this purpose the grammar has to be modified and probably some model classes.
# Make sure that all the variable names used don't conflict with other names (unless the user used them twice).
# Allow injected #{} and %=% into attributes, replacing the functionality of xeb:concat. In a bigger step the grammar for attributes could be expanded to allow Eiffel expressions.
# Establish common names and change tags accordingly if they don't conform. An example is 'type' which should be used instead of 'class'.

=== Xebra Server ===
* Multithreaded request processing

=== Other ===

Xebra Server Administration

2009-09-01T15:49:18Z

Fabioz: /* Run Arguments */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

=Run Xebra Server=
This section describes how to run the server if xebra was installed manually.

* Make sure the server config file is correctly set up. I.e. don't forget to remove '.exe' for linux, make sure to select the 'F_code' directory if you compiled with finalization.
* Run

'''Linux'''
<code>
cd $XEBRA_DEV/eiffel_projects/xebra_server
EIFGENs/xebra_server/F_code/xebra_server config.srv
</code>
'''Windows'''
<code>
cd %XEBRA_DEV%\eiffel_projects\xebra_server
EIFGENs\xebra_server\F_code\xebra_server.exe config.srv
</code>

* Or to see a list of run arguments type instead
'''Linux'''
<code>
EIFGENs/xebra_server/F_code/xebra_server -help
</code>
'''Windows'''
<code>
EIFGENs\xebra_server\F_code\xebra_server.exe -help
</code>

* Stop the server by typing
<code>
exit
</code>
* For a list of server commands type
<code>
help
</code>

=Run Xebra Server in EiffelStudio=
This section describes how to run the server withing EiffelStudio if xebra was installed manually.

# Launch estudio and compile the project $XEBRA_DEV/eiffel_projects/xebra_server/xebra_server.ecf
# Go to the Execution -> Exceptions Handling dialog. Check "Filter Exceptions?" and change DEVELOPER_EXCEPTION to "Ignore".
# Open the Execution -> Execution Parameters dialog and set "config.srv" as argument (see below for more info about run arguments).
# Compile
# Fill in the [[Xebra Server Config File]]
# Run
# Browse to http://localhost/helloworld/. The server now translates, generates, compiles and finally runs the helloworld application.

= Run in Create Webapp Mode=

You can use the server as a tool to only translate, generate and compile a webapp. The application will then not act as a 'server'. Use the '-c' option for that matter.

Example:
$XEBRA_DEV/bin/xebra_server $XEBRA_DEV/conf/config.srv -d 6 -c $XEBRA_DEV/www/demoapplication/config.wapp

You can interrupt and terminate anytime by hitting any key.

=Modules=
The server automatically launches the following modules:
* mod_http: Listens to requests from the http plugin (Apache Module or IIS7 Handler) on port 55001. These request are forwarded to the appropriate webapp.
* mod_console: Reads input from the console. The commands described below can be invoked.
* mod_cmd: Listens to command request from the webapps on port 55002.

{{Note| The server can only be shut down by the servercontrol webapp if the mod_console already has been shut down manually from within the console! This problem is due to the uninteruptability of io.read_line}}

=Webapps=

==Managed and Unmanaged Webapps==
The server can handle two different types of webapps: managed and unmanaged. The attribute "managed_webapps" in the server config file specifies the path to the root of the managed webapps. On startup the server scans this path for webapp config files and loads them. Managed webapps are translated, generated, compiled and run automatically by the server. All managed webapps are run locally. Unmanaged webapps are specified under "unmanaged_webapps" in the server config file. These have to be managed manually by the user but can be run on any other machine. The xebra server application can be used as a tool to only translate, generate and compile a webapp by using the -c option.

If the option -u was set, the server treats all managed webapps as unmanaged ones, i.e. it does not translate, compile and run the webapps but just tries to connect immediately. This should be used when a webapp is launched in estudio for debugging and the server does not need to run and shutdown the webapp.

==Development Mode==
By default, a managed webapp is set to Development Mode which means that the server checks everytime a request was made if the webapp needs to be retranslated and compiled. This makes access to the webapp very slow. As soon as development of the webapp stopps, dev_mod should be set to off.

==Fire off a webapp==
If the server crashed and therefore could not properly shut down all managed webapps, they will still be running when the server is relaunched. Hence, the socket will be occupied when the server tries to launch a webapp. Use the fire command to fire off a possibly running webapp. The fire command tries to directly connect to the webapp and send a shutdown signal regardless if the webapp process is owned by the server or not. This command is also available for unmanaged webapps.

=Config File=
* see [[Xebra Server Config File]]

=Run Arguments=

<code>
USAGE:
xebra_server.exe <config_filename> [-d <debug_level>] [-u] [-c <Webapp config file>] [-v] [-nologo]

OPTIONS:
Options should be prefixed with: '-' or '/'

-d --debug_level : Specifies a debug level.
1: Start and stop of overall application
2: Application configuration
3: Start and stop of main components
4: Information about tasks that are performed
5: Information about subtasks that are performed
6: Very verbose information about subtasks that are performed (Optional)
-u --unmanaged : If set, the server treats all managed webapps as unmanged webapps. (Optional)
-c --create_webapp: With this switch the server can be used as a tool to translate, generate and compile the
specified webapp (Optional)
-? --help : Display usage information. (Optional)
-v --version : Displays version information. (Optional)
--nologo : Supresses copyright information. (Optional)

ARGUMENTS:
<debug_level> : The debug level (1-6)
<Webapp config file>: The webapp config file

NON-SWITCHED ARGUMENTS:
<config_filename>: The path of the config file to use.
</code>

=Console Commands=
- 'help': Displays a list of commands

===Server Control===
- 'exit': Shuts down the server.
- 'reload': Reloads the server configuration file.
- 'shutdown_webapps': Shuts down all webapps.

===Modules===
- 'mlaunch <name>': Re-launches a server module.
- 'modules': Displays the available modules.
- 'mshutdown <name>': Shuts down a server module.

=== Webapps===
- 'clean <name>': Cleans, re-translates, compiles and launches a webapp. (Managed webapp only)
- 'dev <name>': Sets developing mode of a webapp to on. (Managed webapp only)
- 'dev_all': Sets dev_mod to on on all webapps.
- 'dev_off <name>': Sets developing mode of a webapp to off. (Managed webapp only)
- 'dev_off_all': Sets dev_mod to off on all webapps.
- 'dev_on <name>': Sets developing mode of a webapp to on. (Managed webapp only)
- 'disable <name>': Disables a webapp.
- 'enable <name>': Enables a webapp.
- 'fire <name>': Sends shutdown signal directly to webapp.
- 'shutdown <name>': Shuts down a webapp. (Managed webapp only)
- 'translate <name>': Forces re-translation of webapp (without cleaning). (Managed webapp only)
- 'webapps': Displays the available webapps.

Xebra Server Administration

2009-09-01T15:48:26Z

Fabioz: /* Managed and Unmanaged Webapps */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

=Run Xebra Server=
This section describes how to run the server if xebra was installed manually.

* Make sure the server config file is correctly set up. I.e. don't forget to remove '.exe' for linux, make sure to select the 'F_code' directory if you compiled with finalization.
* Run

'''Linux'''
<code>
cd $XEBRA_DEV/eiffel_projects/xebra_server
EIFGENs/xebra_server/F_code/xebra_server config.srv
</code>
'''Windows'''
<code>
cd %XEBRA_DEV%\eiffel_projects\xebra_server
EIFGENs\xebra_server\F_code\xebra_server.exe config.srv
</code>

* Or to see a list of run arguments type instead
'''Linux'''
<code>
EIFGENs/xebra_server/F_code/xebra_server -help
</code>
'''Windows'''
<code>
EIFGENs\xebra_server\F_code\xebra_server.exe -help
</code>

* Stop the server by typing
<code>
exit
</code>
* For a list of server commands type
<code>
help
</code>

=Run Xebra Server in EiffelStudio=
This section describes how to run the server withing EiffelStudio if xebra was installed manually.

# Launch estudio and compile the project $XEBRA_DEV/eiffel_projects/xebra_server/xebra_server.ecf
# Go to the Execution -> Exceptions Handling dialog. Check "Filter Exceptions?" and change DEVELOPER_EXCEPTION to "Ignore".
# Open the Execution -> Execution Parameters dialog and set "config.srv" as argument (see below for more info about run arguments).
# Compile
# Fill in the [[Xebra Server Config File]]
# Run
# Browse to http://localhost/helloworld/. The server now translates, generates, compiles and finally runs the helloworld application.

= Run in Create Webapp Mode=

You can use the server as a tool to only translate, generate and compile a webapp. The application will then not act as a 'server'. Use the '-c' option for that matter.

Example:
$XEBRA_DEV/bin/xebra_server $XEBRA_DEV/conf/config.srv -d 6 -c $XEBRA_DEV/www/demoapplication/config.wapp

You can interrupt and terminate anytime by hitting any key.

=Modules=
The server automatically launches the following modules:
* mod_http: Listens to requests from the http plugin (Apache Module or IIS7 Handler) on port 55001. These request are forwarded to the appropriate webapp.
* mod_console: Reads input from the console. The commands described below can be invoked.
* mod_cmd: Listens to command request from the webapps on port 55002.

{{Note| The server can only be shut down by the servercontrol webapp if the mod_console already has been shut down manually from within the console! This problem is due to the uninteruptability of io.read_line}}

=Webapps=

==Managed and Unmanaged Webapps==
The server can handle two different types of webapps: managed and unmanaged. The attribute "managed_webapps" in the server config file specifies the path to the root of the managed webapps. On startup the server scans this path for webapp config files and loads them. Managed webapps are translated, generated, compiled and run automatically by the server. All managed webapps are run locally. Unmanaged webapps are specified under "unmanaged_webapps" in the server config file. These have to be managed manually by the user but can be run on any other machine. The xebra server application can be used as a tool to only translate, generate and compile a webapp by using the -c option.

If the option -u was set, the server treats all managed webapps as unmanaged ones, i.e. it does not translate, compile and run the webapps but just tries to connect immediately. This should be used when a webapp is launched in estudio for debugging and the server does not need to run and shutdown the webapp.

==Development Mode==
By default, a managed webapp is set to Development Mode which means that the server checks everytime a request was made if the webapp needs to be retranslated and compiled. This makes access to the webapp very slow. As soon as development of the webapp stopps, dev_mod should be set to off.

==Fire off a webapp==
If the server crashed and therefore could not properly shut down all managed webapps, they will still be running when the server is relaunched. Hence, the socket will be occupied when the server tries to launch a webapp. Use the fire command to fire off a possibly running webapp. The fire command tries to directly connect to the webapp and send a shutdown signal regardless if the webapp process is owned by the server or not. This command is also available for unmanaged webapps.

=Config File=
* see [[Xebra Server Config File]]

=Run Arguments=

<code>
USAGE:
xebra_server.exe <config_filename> [-d <debug_level>] [-u] [-c <Webapp config file>] [-v] [-nologo]

OPTIONS:
Options should be prefixed with: '-' or '/'

-d --debug_level : Specifies a debug level.
1: Start and stop of overall application
2: Application configuration
3: Start and stop of main components
4: Information about tasks that are performed
5: Information about subtasks that are performed
6: Very verbose information about subtasks that are performed (Optional)
-u --unmanaged : If set, the server treats all managed webapps as unmanged webapps. (Optional)
-c --create_webapp: With this switch the server can be used as a tool to translate, generate and compile the
specified webapp (Optional)
-? --help : Display usage information. (Optional)
-v --version : Displays version information. (Optional)
--nologo : Supresses copyright information. (Optional)

ARGUMENTS:
<debug_level> : The debug level (1-6)
<Webapp config file>: The webapp config file

NON-SWITCHED ARGUMENTS:
<config_filename>: The path of the config.ini file to use.
</code>

=Console Commands=
- 'help': Displays a list of commands

===Server Control===
- 'exit': Shuts down the server.
- 'reload': Reloads the server configuration file.
- 'shutdown_webapps': Shuts down all webapps.

===Modules===
- 'mlaunch <name>': Re-launches a server module.
- 'modules': Displays the available modules.
- 'mshutdown <name>': Shuts down a server module.

=== Webapps===
- 'clean <name>': Cleans, re-translates, compiles and launches a webapp. (Managed webapp only)
- 'dev <name>': Sets developing mode of a webapp to on. (Managed webapp only)
- 'dev_all': Sets dev_mod to on on all webapps.
- 'dev_off <name>': Sets developing mode of a webapp to off. (Managed webapp only)
- 'dev_off_all': Sets dev_mod to off on all webapps.
- 'dev_on <name>': Sets developing mode of a webapp to on. (Managed webapp only)
- 'disable <name>': Disables a webapp.
- 'enable <name>': Enables a webapp.
- 'fire <name>': Sends shutdown signal directly to webapp.
- 'shutdown <name>': Shuts down a webapp. (Managed webapp only)
- 'translate <name>': Forces re-translation of webapp (without cleaning). (Managed webapp only)
- 'webapps': Displays the available webapps.

Xebra Server Administration

2009-09-01T15:43:01Z

Fabioz: /* Run in Create Webapp Mode */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

=Run Xebra Server=
This section describes how to run the server if xebra was installed manually.

* Make sure the server config file is correctly set up. I.e. don't forget to remove '.exe' for linux, make sure to select the 'F_code' directory if you compiled with finalization.
* Run

'''Linux'''
<code>
cd $XEBRA_DEV/eiffel_projects/xebra_server
EIFGENs/xebra_server/F_code/xebra_server config.srv
</code>
'''Windows'''
<code>
cd %XEBRA_DEV%\eiffel_projects\xebra_server
EIFGENs\xebra_server\F_code\xebra_server.exe config.srv
</code>

* Or to see a list of run arguments type instead
'''Linux'''
<code>
EIFGENs/xebra_server/F_code/xebra_server -help
</code>
'''Windows'''
<code>
EIFGENs\xebra_server\F_code\xebra_server.exe -help
</code>

* Stop the server by typing
<code>
exit
</code>
* For a list of server commands type
<code>
help
</code>

=Run Xebra Server in EiffelStudio=
This section describes how to run the server withing EiffelStudio if xebra was installed manually.

# Launch estudio and compile the project $XEBRA_DEV/eiffel_projects/xebra_server/xebra_server.ecf
# Go to the Execution -> Exceptions Handling dialog. Check "Filter Exceptions?" and change DEVELOPER_EXCEPTION to "Ignore".
# Open the Execution -> Execution Parameters dialog and set "config.srv" as argument (see below for more info about run arguments).
# Compile
# Fill in the [[Xebra Server Config File]]
# Run
# Browse to http://localhost/helloworld/. The server now translates, generates, compiles and finally runs the helloworld application.

= Run in Create Webapp Mode=

You can use the server as a tool to only translate, generate and compile a webapp. The application will then not act as a 'server'. Use the '-c' option for that matter.

Example:
$XEBRA_DEV/bin/xebra_server $XEBRA_DEV/conf/config.srv -d 6 -c $XEBRA_DEV/www/demoapplication/config.wapp

You can interrupt and terminate anytime by hitting any key.

=Modules=
The server automatically launches the following modules:
* mod_http: Listens to requests from the http plugin (Apache Module or IIS7 Handler) on port 55001. These request are forwarded to the appropriate webapp.
* mod_console: Reads input from the console. The commands described below can be invoked.
* mod_cmd: Listens to command request from the webapps on port 55002.

{{Note| The server can only be shut down by the servercontrol webapp if the mod_console already has been shut down manually from within the console! This problem is due to the uninteruptability of io.read_line}}

=Webapps=

==Managed and Unmanaged Webapps==
The server can handle two different types of webapps: managed and unmanaged. The attribute "managed_webapps" in the server config file specifies the path to the root of the managed webapps. On startup the server scans this path for webapp config files and loads them. Managed webapps are translated, generated, compiled and run automatically by the server. All managed webapps are run locally. Unmanaged webapps are specified under "unmanaged_webapps" in the server config file. These have to be managed manually by the user but can be run on any other machine. The xebra server application can be used as a tool to only translate, generate and compile a webapp by using the -c option.

If the option -u was set, the server treats all managed webapps as unmanaged ones, i.e. it does not translate, compile and run the webapps but just tries to connect immediately. This should be used when a webapp is launched in estudio for debugging and the server should not try to run and shutdown the webapp.

==Development Mode==
By default, a managed webapp is set to Development Mode which means that the server checks everytime a request was made if the webapp needs to be retranslated and compiled. This makes access to the webapp very slow. As soon as development of the webapp stopps, dev_mod should be set to off.

==Fire off a webapp==
If the server crashed and therefore could not properly shut down all managed webapps, they will still be running when the server is relaunched. Hence, the socket will be occupied when the server tries to launch a webapp. Use the fire command to fire off a possibly running webapp. The fire command tries to directly connect to the webapp and send a shutdown signal regardless if the webapp process is owned by the server or not. This command is also available for unmanaged webapps.

=Config File=
* see [[Xebra Server Config File]]

=Run Arguments=

<code>
USAGE:
xebra_server.exe <config_filename> [-d <debug_level>] [-u] [-c <Webapp config file>] [-v] [-nologo]

OPTIONS:
Options should be prefixed with: '-' or '/'

-d --debug_level : Specifies a debug level.
1: Start and stop of overall application
2: Application configuration
3: Start and stop of main components
4: Information about tasks that are performed
5: Information about subtasks that are performed
6: Very verbose information about subtasks that are performed (Optional)
-u --unmanaged : If set, the server treats all managed webapps as unmanged webapps. (Optional)
-c --create_webapp: With this switch the server can be used as a tool to translate, generate and compile the
specified webapp (Optional)
-? --help : Display usage information. (Optional)
-v --version : Displays version information. (Optional)
--nologo : Supresses copyright information. (Optional)

ARGUMENTS:
<debug_level> : The debug level (1-6)
<Webapp config file>: The webapp config file

NON-SWITCHED ARGUMENTS:
<config_filename>: The path of the config.ini file to use.
</code>

=Console Commands=
- 'help': Displays a list of commands

===Server Control===
- 'exit': Shuts down the server.
- 'reload': Reloads the server configuration file.
- 'shutdown_webapps': Shuts down all webapps.

===Modules===
- 'mlaunch <name>': Re-launches a server module.
- 'modules': Displays the available modules.
- 'mshutdown <name>': Shuts down a server module.

=== Webapps===
- 'clean <name>': Cleans, re-translates, compiles and launches a webapp. (Managed webapp only)
- 'dev <name>': Sets developing mode of a webapp to on. (Managed webapp only)
- 'dev_all': Sets dev_mod to on on all webapps.
- 'dev_off <name>': Sets developing mode of a webapp to off. (Managed webapp only)
- 'dev_off_all': Sets dev_mod to off on all webapps.
- 'dev_on <name>': Sets developing mode of a webapp to on. (Managed webapp only)
- 'disable <name>': Disables a webapp.
- 'enable <name>': Enables a webapp.
- 'fire <name>': Sends shutdown signal directly to webapp.
- 'shutdown <name>': Shuts down a webapp. (Managed webapp only)
- 'translate <name>': Forces re-translation of webapp (without cleaning). (Managed webapp only)
- 'webapps': Displays the available webapps.

Xebra Server Administration

2009-09-01T15:42:20Z

Fabioz: /* Run in Create Webapp Mode */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

=Run Xebra Server=
This section describes how to run the server if xebra was installed manually.

* Make sure the server config file is correctly set up. I.e. don't forget to remove '.exe' for linux, make sure to select the 'F_code' directory if you compiled with finalization.
* Run

'''Linux'''
<code>
cd $XEBRA_DEV/eiffel_projects/xebra_server
EIFGENs/xebra_server/F_code/xebra_server config.srv
</code>
'''Windows'''
<code>
cd %XEBRA_DEV%\eiffel_projects\xebra_server
EIFGENs\xebra_server\F_code\xebra_server.exe config.srv
</code>

* Or to see a list of run arguments type instead
'''Linux'''
<code>
EIFGENs/xebra_server/F_code/xebra_server -help
</code>
'''Windows'''
<code>
EIFGENs\xebra_server\F_code\xebra_server.exe -help
</code>

* Stop the server by typing
<code>
exit
</code>
* For a list of server commands type
<code>
help
</code>

=Run Xebra Server in EiffelStudio=
This section describes how to run the server withing EiffelStudio if xebra was installed manually.

# Launch estudio and compile the project $XEBRA_DEV/eiffel_projects/xebra_server/xebra_server.ecf
# Go to the Execution -> Exceptions Handling dialog. Check "Filter Exceptions?" and change DEVELOPER_EXCEPTION to "Ignore".
# Open the Execution -> Execution Parameters dialog and set "config.srv" as argument (see below for more info about run arguments).
# Compile
# Fill in the [[Xebra Server Config File]]
# Run
# Browse to http://localhost/helloworld/. The server now translates, generates, compiles and finally runs the helloworld application.

= Run in Create Webapp Mode=

You can use the server as a tool to only translate, generate and compile a webapp. The application will then not act as a 'server'.

Example:
$XEBRA_DEV/bin/xebra_server $XEBRA_DEV/conf/config.srv -d 6 -c $XEBRA_DEV/www/demoapplication/config.wapp

You can interrupt and terminate anytime by hitting any key.

=Modules=
The server automatically launches the following modules:
* mod_http: Listens to requests from the http plugin (Apache Module or IIS7 Handler) on port 55001. These request are forwarded to the appropriate webapp.
* mod_console: Reads input from the console. The commands described below can be invoked.
* mod_cmd: Listens to command request from the webapps on port 55002.

{{Note| The server can only be shut down by the servercontrol webapp if the mod_console already has been shut down manually from within the console! This problem is due to the uninteruptability of io.read_line}}

=Webapps=

==Managed and Unmanaged Webapps==
The server can handle two different types of webapps: managed and unmanaged. The attribute "managed_webapps" in the server config file specifies the path to the root of the managed webapps. On startup the server scans this path for webapp config files and loads them. Managed webapps are translated, generated, compiled and run automatically by the server. All managed webapps are run locally. Unmanaged webapps are specified under "unmanaged_webapps" in the server config file. These have to be managed manually by the user but can be run on any other machine. The xebra server application can be used as a tool to only translate, generate and compile a webapp by using the -c option.

If the option -u was set, the server treats all managed webapps as unmanaged ones, i.e. it does not translate, compile and run the webapps but just tries to connect immediately. This should be used when a webapp is launched in estudio for debugging and the server should not try to run and shutdown the webapp.

==Development Mode==
By default, a managed webapp is set to Development Mode which means that the server checks everytime a request was made if the webapp needs to be retranslated and compiled. This makes access to the webapp very slow. As soon as development of the webapp stopps, dev_mod should be set to off.

==Fire off a webapp==
If the server crashed and therefore could not properly shut down all managed webapps, they will still be running when the server is relaunched. Hence, the socket will be occupied when the server tries to launch a webapp. Use the fire command to fire off a possibly running webapp. The fire command tries to directly connect to the webapp and send a shutdown signal regardless if the webapp process is owned by the server or not. This command is also available for unmanaged webapps.

=Config File=
* see [[Xebra Server Config File]]

=Run Arguments=

<code>
USAGE:
xebra_server.exe <config_filename> [-d <debug_level>] [-u] [-c <Webapp config file>] [-v] [-nologo]

OPTIONS:
Options should be prefixed with: '-' or '/'

-d --debug_level : Specifies a debug level.
1: Start and stop of overall application
2: Application configuration
3: Start and stop of main components
4: Information about tasks that are performed
5: Information about subtasks that are performed
6: Very verbose information about subtasks that are performed (Optional)
-u --unmanaged : If set, the server treats all managed webapps as unmanged webapps. (Optional)
-c --create_webapp: With this switch the server can be used as a tool to translate, generate and compile the
specified webapp (Optional)
-? --help : Display usage information. (Optional)
-v --version : Displays version information. (Optional)
--nologo : Supresses copyright information. (Optional)

ARGUMENTS:
<debug_level> : The debug level (1-6)
<Webapp config file>: The webapp config file

NON-SWITCHED ARGUMENTS:
<config_filename>: The path of the config.ini file to use.
</code>

=Console Commands=
- 'help': Displays a list of commands

===Server Control===
- 'exit': Shuts down the server.
- 'reload': Reloads the server configuration file.
- 'shutdown_webapps': Shuts down all webapps.

===Modules===
- 'mlaunch <name>': Re-launches a server module.
- 'modules': Displays the available modules.
- 'mshutdown <name>': Shuts down a server module.

=== Webapps===
- 'clean <name>': Cleans, re-translates, compiles and launches a webapp. (Managed webapp only)
- 'dev <name>': Sets developing mode of a webapp to on. (Managed webapp only)
- 'dev_all': Sets dev_mod to on on all webapps.
- 'dev_off <name>': Sets developing mode of a webapp to off. (Managed webapp only)
- 'dev_off_all': Sets dev_mod to off on all webapps.
- 'dev_on <name>': Sets developing mode of a webapp to on. (Managed webapp only)
- 'disable <name>': Disables a webapp.
- 'enable <name>': Enables a webapp.
- 'fire <name>': Sends shutdown signal directly to webapp.
- 'shutdown <name>': Shuts down a webapp. (Managed webapp only)
- 'translate <name>': Forces re-translation of webapp (without cleaning). (Managed webapp only)
- 'webapps': Displays the available webapps.

Xebra Server Administration

2009-09-01T15:29:34Z

Fabioz:

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

=Run Xebra Server=
This section describes how to run the server if xebra was installed manually.

* Make sure the server config file is correctly set up. I.e. don't forget to remove '.exe' for linux, make sure to select the 'F_code' directory if you compiled with finalization.
* Run

'''Linux'''
<code>
cd $XEBRA_DEV/eiffel_projects/xebra_server
EIFGENs/xebra_server/F_code/xebra_server config.srv
</code>
'''Windows'''
<code>
cd %XEBRA_DEV%\eiffel_projects\xebra_server
EIFGENs\xebra_server\F_code\xebra_server.exe config.srv
</code>

* Or to see a list of run arguments type instead
'''Linux'''
<code>
EIFGENs/xebra_server/F_code/xebra_server -help
</code>
'''Windows'''
<code>
EIFGENs\xebra_server\F_code\xebra_server.exe -help
</code>

* Stop the server by typing
<code>
exit
</code>
* For a list of server commands type
<code>
help
</code>

=Run Xebra Server in EiffelStudio=
This section describes how to run the server withing EiffelStudio if xebra was installed manually.

# Launch estudio and compile the project $XEBRA_DEV/eiffel_projects/xebra_server/xebra_server.ecf
# Go to the Execution -> Exceptions Handling dialog. Check "Filter Exceptions?" and change DEVELOPER_EXCEPTION to "Ignore".
# Open the Execution -> Execution Parameters dialog and set "config.srv" as argument (see below for more info about run arguments).
# Compile
# Fill in the [[Xebra Server Config File]]
# Run
# Browse to http://localhost/helloworld/. The server now translates, generates, compiles and finally runs the helloworld application.

= Run in Create Webapp Mode=

=Modules=
The server automatically launches the following modules:
* mod_http: Listens to requests from the http plugin (Apache Module or IIS7 Handler) on port 55001. These request are forwarded to the appropriate webapp.
* mod_console: Reads input from the console. The commands described below can be invoked.
* mod_cmd: Listens to command request from the webapps on port 55002.

{{Note| The server can only be shut down by the servercontrol webapp if the mod_console already has been shut down manually from within the console! This problem is due to the uninteruptability of io.read_line}}

=Webapps=

==Managed and Unmanaged Webapps==
The server can handle two different types of webapps: managed and unmanaged. The attribute "managed_webapps" in the server config file specifies the path to the root of the managed webapps. On startup the server scans this path for webapp config files and loads them. Managed webapps are translated, generated, compiled and run automatically by the server. All managed webapps are run locally. Unmanaged webapps are specified under "unmanaged_webapps" in the server config file. These have to be managed manually by the user but can be run on any other machine. The xebra server application can be used as a tool to only translate, generate and compile a webapp by using the -c option.

If the option -u was set, the server treats all managed webapps as unmanaged ones, i.e. it does not translate, compile and run the webapps but just tries to connect immediately. This should be used when a webapp is launched in estudio for debugging and the server should not try to run and shutdown the webapp.

==Development Mode==
By default, a managed webapp is set to Development Mode which means that the server checks everytime a request was made if the webapp needs to be retranslated and compiled. This makes access to the webapp very slow. As soon as development of the webapp stopps, dev_mod should be set to off.

==Fire off a webapp==
If the server crashed and therefore could not properly shut down all managed webapps, they will still be running when the server is relaunched. Hence, the socket will be occupied when the server tries to launch a webapp. Use the fire command to fire off a possibly running webapp. The fire command tries to directly connect to the webapp and send a shutdown signal regardless if the webapp process is owned by the server or not. This command is also available for unmanaged webapps.

=Config File=
* see [[Xebra Server Config File]]

=Run Arguments=

<code>
USAGE:
xebra_server.exe <config_filename> [-d <debug_level>] [-u] [-c <Webapp config file>] [-v] [-nologo]

OPTIONS:
Options should be prefixed with: '-' or '/'

-d --debug_level : Specifies a debug level.
1: Start and stop of overall application
2: Application configuration
3: Start and stop of main components
4: Information about tasks that are performed
5: Information about subtasks that are performed
6: Very verbose information about subtasks that are performed (Optional)
-u --unmanaged : If set, the server treats all managed webapps as unmanged webapps. (Optional)
-c --create_webapp: With this switch the server can be used as a tool to translate, generate and compile the
specified webapp (Optional)
-? --help : Display usage information. (Optional)
-v --version : Displays version information. (Optional)
--nologo : Supresses copyright information. (Optional)

ARGUMENTS:
<debug_level> : The debug level (1-6)
<Webapp config file>: The webapp config file

NON-SWITCHED ARGUMENTS:
<config_filename>: The path of the config.ini file to use.
</code>

=Console Commands=
- 'help': Displays a list of commands

===Server Control===
- 'exit': Shuts down the server.
- 'reload': Reloads the server configuration file.
- 'shutdown_webapps': Shuts down all webapps.

===Modules===
- 'mlaunch <name>': Re-launches a server module.
- 'modules': Displays the available modules.
- 'mshutdown <name>': Shuts down a server module.

=== Webapps===
- 'clean <name>': Cleans, re-translates, compiles and launches a webapp. (Managed webapp only)
- 'dev <name>': Sets developing mode of a webapp to on. (Managed webapp only)
- 'dev_all': Sets dev_mod to on on all webapps.
- 'dev_off <name>': Sets developing mode of a webapp to off. (Managed webapp only)
- 'dev_off_all': Sets dev_mod to off on all webapps.
- 'dev_on <name>': Sets developing mode of a webapp to on. (Managed webapp only)
- 'disable <name>': Disables a webapp.
- 'enable <name>': Enables a webapp.
- 'fire <name>': Sends shutdown signal directly to webapp.
- 'shutdown <name>': Shuts down a webapp. (Managed webapp only)
- 'translate <name>': Forces re-translation of webapp (without cleaning). (Managed webapp only)
- 'webapps': Displays the available webapps.

Xebra Tutorial

2009-09-01T15:24:02Z

Fabioz: /* Apache */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

=Server=
* Run Xebra Server: [[Xebra Server Administration]]

=Webapp=
* Create a webapp: [[Xebra Create Webapps|Create Webapps]]
* Debug a webapp: [[Xebra Debug Webapp|Debug Webapp]]
* Write a xeb file: [[Xebra Write Xeb File|Write Xeb File]]
* Add XML-RPC support ((xml_rpc is currently disabled)): [[Xebra Create XML-RPC Webapp]]

=Extend Xebra=
*Create your own tag libraries: [[Xebra Create Tag Library|Create custom tag library]]

Xebra Tutorial

2009-09-01T15:23:51Z

Fabioz: /* Webapp */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

=Server=
* Run Xebra Server: [[Xebra Server Administration]]

=Webapp=
* Create a webapp: [[Xebra Create Webapps|Create Webapps]]
* Debug a webapp: [[Xebra Debug Webapp|Debug Webapp]]
* Write a xeb file: [[Xebra Write Xeb File|Write Xeb File]]
* Add XML-RPC support ((xml_rpc is currently disabled)): [[Xebra Create XML-RPC Webapp]]

=Extend Xebra=
*Create your own tag libraries: [[Xebra Create Tag Library|Create custom tag library]]

=Apache=

Xebra Create Webapps

2009-09-01T15:23:15Z

Fabioz: /* Add support for XML-RPC */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

=Create a new webapp=

# Setup an initial Eiffel project for your webapp. For that matter you can use this [https://svn.eiffel.com/eiffelstudio/trunk/Src/framework/web/xebra/tools/scripts/linux/create_website.sh script] which creates all necessary files. Make sure to assign a free port to your webapp (see also [[Xebra Webapp Config File]]). The webapp has to be created in the same folder that is specified in the servers config file at unmanaged_webapps. See [[Xebra Server Config File]] for more information.
# Run the server (see [[Xebra Server Administration]]) and browse to http://localhost:55000/yourwebapp. The server will translate and compile your webapp. Once compiled, you should see a page displaying "Yourwebapp works!".
# Create xeb files for your webapp. See [[Xebra Documentation|Xebra Tag Libraries]] for more info about xeb tags (see also [[Xebra Write Xeb File | Tutorial]]). Note that you have to let the server re-translate your webapp everytime you change xeb-files or add new xeb-files. This can be done by just pressing F5 in the browser. The server automatically detects that the webapp has to be re-translated if it is set to Development Mode (see [[Xebra Server Administration]] for more info).
# Create the eiffel classes.

=Add support for XML-RPC=
* [[Xebra Create XML-RPC Webapp]] (xml_rpc is currently disabled)

=Manually translate a webapp=
To manually translate, generate and compile your webapp use the following commands

Linux
<code>
cd $XEBRA_DEV/httpd/htdocs/yourwebapp/

#Translate
$XEBRA_DEV/eiffel_projects/xebra_translator/EIFGENs/xebra_translator/W_code/xebra_translator -n yourwebapp -i . -o . -l $XEBRA_DEV/eiffel_projects/xebra_translator

#Compile servlet_gen
ec -experiment -config .generated/servlet_gen/servlet_gen.ecf -target servlet_gen -c_compile -stop

#Execute servlet_gen
.generated/servlet_gen/EIFGENs/servlet_gen/W_code/servlet_gen -o .

#Compile webapp
ec -experiment -config yourwebapp.ecf -target yourwebapp -c_compile -stop
</code>

Windows
<code>
cd %XEBRA_DEV%\httpd\htdocs\yourwebapp\

#Translate
%XEBRA_DEV%\eiffel_projects\xebra_translator\EIFGENs\xebra_translator\W_code\xebra_translator -n yourwebapp -i . -o . -l %XEBRA_DEV%\eiffel_projects\xebra_translator

#Compile servlet_gen
ec -experiment -config .generated\servlet_gen\servlet_gen.ecf -target servlet_gen -c_compile -stop

#Execute servlet_gen
.generated\servlet_gen\EIFGENs\servlet_gen\W_code\servlet_gen.exe .

#Compile webapp
ec -experiment -config yourwebapp.ecf -target yourwebapp -c_compile -stop
</code>

Optionally, you can add the "-clean" option for ec and the "-f" option for translator to force a complete recompilation.

Xebra Create Webapps

2009-09-01T15:22:45Z

Fabioz: /* Create a new webapp */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

=Create a new webapp=

# Setup an initial Eiffel project for your webapp. For that matter you can use this [https://svn.eiffel.com/eiffelstudio/trunk/Src/framework/web/xebra/tools/scripts/linux/create_website.sh script] which creates all necessary files. Make sure to assign a free port to your webapp (see also [[Xebra Webapp Config File]]). The webapp has to be created in the same folder that is specified in the servers config file at unmanaged_webapps. See [[Xebra Server Config File]] for more information.
# Run the server (see [[Xebra Server Administration]]) and browse to http://localhost:55000/yourwebapp. The server will translate and compile your webapp. Once compiled, you should see a page displaying "Yourwebapp works!".
# Create xeb files for your webapp. See [[Xebra Documentation|Xebra Tag Libraries]] for more info about xeb tags (see also [[Xebra Write Xeb File | Tutorial]]). Note that you have to let the server re-translate your webapp everytime you change xeb-files or add new xeb-files. This can be done by just pressing F5 in the browser. The server automatically detects that the webapp has to be re-translated if it is set to Development Mode (see [[Xebra Server Administration]] for more info).
# Create the eiffel classes.

=Add support for XML-RPC=
* [[Xebra Create XML-RPC Webapp]]

=Manually translate a webapp=
To manually translate, generate and compile your webapp use the following commands

Linux
<code>
cd $XEBRA_DEV/httpd/htdocs/yourwebapp/

#Translate
$XEBRA_DEV/eiffel_projects/xebra_translator/EIFGENs/xebra_translator/W_code/xebra_translator -n yourwebapp -i . -o . -l $XEBRA_DEV/eiffel_projects/xebra_translator

#Compile servlet_gen
ec -experiment -config .generated/servlet_gen/servlet_gen.ecf -target servlet_gen -c_compile -stop

#Execute servlet_gen
.generated/servlet_gen/EIFGENs/servlet_gen/W_code/servlet_gen -o .

#Compile webapp
ec -experiment -config yourwebapp.ecf -target yourwebapp -c_compile -stop
</code>

Windows
<code>
cd %XEBRA_DEV%\httpd\htdocs\yourwebapp\

#Translate
%XEBRA_DEV%\eiffel_projects\xebra_translator\EIFGENs\xebra_translator\W_code\xebra_translator -n yourwebapp -i . -o . -l %XEBRA_DEV%\eiffel_projects\xebra_translator

#Compile servlet_gen
ec -experiment -config .generated\servlet_gen\servlet_gen.ecf -target servlet_gen -c_compile -stop

#Execute servlet_gen
.generated\servlet_gen\EIFGENs\servlet_gen\W_code\servlet_gen.exe .

#Compile webapp
ec -experiment -config yourwebapp.ecf -target yourwebapp -c_compile -stop
</code>

Optionally, you can add the "-clean" option for ec and the "-f" option for translator to force a complete recompilation.

Xebra Installation

2009-09-01T15:16:12Z

Fabioz: /* Windows Installer (NEW) */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

=Installations=
===There are two ways to install Xebra:===
*Automatic
** A script for Ubuntu 9.04 that sets up xebra and also installs apache
** A Windows Installer that contains xebra and apache and sets it up
*Manual (Step-by-step guide)
** Ubuntu 9.04 with Apache
** Windows with Apache
** Windows with IIS7

===A few notes===
*All of xebra is compiled with the -experiment option. We haven't tested to compile anything in non-experimental mode.
*Currently (rev 80407), for all types of installation you have to adapt a files in ISE_LIBRARY to make it work since there is a bug in the eiffel argument parser library: In the class ''ISE_EIFFEL/experimental/library/argument_parser/parsers/argument_base_parser.e'' in the feature ''arguments: ARRAY [STRING]'' replace the line
<code>
create Result.make (1, l_result.count)
</code>
with
<code>
create Result.make_filled ("", 1, l_result.count)
</code>

=Ubuntu Installation Script =
{{Note| This script was tested with Xebra revision 80545, EiffelStudio 6.5.8.294 and Ubuntu 9.04 (August 2009)}}

Run this script (the current revision):
https://svn.eiffel.com/eiffelstudio/trunk/Src/framework/web/xebra/tools/scripts/linux/install_xebra_ubuntu.sh

The script expects $XEBRA_DEV, $ISE_EIFFEL and $ISE_LIBRARY to be set. Please make sure ''svn'', ''wget'', ''vim'' and ''tar'' are installed. Also, the path to your eiffel studio bin folder should be included in your PATH variable.

The script will checkout xebra to $XEBRA_DEV, compile the server and translator, download, install and configure apache to $XEBRA_DEV/apache. Apache will be configured to listen on port 55000 (instead of 80) in order to not interfere with an already installed http server. After the script was successfully run you need to set $XEBRA_LIBRARY to $XEBRA_DEV/library.

To test you installation run
$XEBRA_DEV/bin/launch_apache.sh
$XEBRA_DEV/bin/launch_server.sh
and then browse to
http://localhost:55000/helloworld
The server will then start compiling the xebra precompile library and generate the helloworld webapp. It can take a while to do so the first time (If you want to see what's happening type 'debug_level 6' in the server console). While compiling you will see a page saying "Application 'helloworld' is compiling...". After a while hit F5 and you should see "Hello WORLD!" (or "Hello world!").

=Windows Installer =
{{Note| This installer was tested with Xebra revision 80545, EiffelStudio 6.5.8.294, on Windows XP SP2}}

Run the installer at:

https://svn.origo.ethz.ch/eiffelstudio/trunk/Src/framework/web/xebra/tools/installer/win/innosetup/output/XebraSetup.exe

To test your installation click "Launch Xebra Full" in the "Eiffel Xebra" folder in your start menu. This will launch apache and the xebra server and it will open "localhost:55000/helloworld" in your browser.
The server will then start compiling the xebra precompile library and generate the helloworld webapp. It can take a while to do so the first time (If you want to see what's happening type 'debug_level 6' in the server console). While compiling you will see a page saying "Application 'helloworld' is compiling...". After a while hit F5 and you should see "Hello WORLD!" (or "Hello world!").

=Manual Installation=
This guide expects Eiffel Studio to be installed to $ISE_EIFFEL and the source to be checked out to $EIFFEL_SRC (only the folder 'framework' is needed).

==Checkout Xebra==
* Define $XEBRA_DEV and checkout xebra from https://svn.eiffel.com/eiffelstudio/trunk/Src/framework/web/xebra/ to $XEBRA_DEV
* Define $XEBRA_LIBRARY to $XEBRA_DEV/eiffel_projects/library

==Install HTTP Server==
=== Ubuntu 9.04 with Apache 2.2.11 ===
Note:
* Mod_xebra does currently not run with the apache distribution that comes with ubuntu.

* Download apache unix source from http://httpd.apache.org/download.cgi
* Extract
* Define $APACHE2 where you want to install apache, e.g. to $XEBRA_DEV/apache
* Run the following commands in the extracted folder:
CFLAGS="-ggdb"
./configure --prefix=$APACHE2
make
make install
* Compile the module by running
cd $XEBRA_DEV/c_projects/apache_mod_xebra
$APACHE2/bin/apxs -c mod_xebra.c mod_xebra.h
* Install the module to apache by running
$APACHE2/bin/apxs -i mod_xebra.la
* Add the following lines to $APACHE2/conf/httpd.conf:
<code>
#Xebra Module
LoadModule xebra_module modules/mod_xebra.so

<IfModule xebra_module>
AddHandler mod_xebra .xeb
AddHandler mod_xebra .xrpc
XebraServer_port 55001
XebraServer_host "127.0.0.1"
XebraServer_max_upload_size 10000000
XebraServer_upload_path "/tmp"
DirectoryIndex index.xeb
<Files ~ "\.(ini|e|ecf)$">
Order allow,deny
Deny from all
</Files>
<Directory ~ "EIFGENs">
Order allow,deny
Deny from all
</Directory>
</IfModule>
</code>
* Also in httpd.conf, change ''DocumentRoot'' to ''{path to xebra}\www'' and don't forget the directory options below the line ''# This should be changed to whatever you set DocumentRoot to.''
* Create the directory ''/tmp'' or choose another temp upload directory.
* Restart apache
$APACHE2/bin/apachectl restart
* Browse to ''http://localhost/test.xeb''. You should see a message saying ''Cannot connect to XebraServer. See apache error log.''
* Hint: keep an eye on the apache error log
<code>
tail -f $APACHE2/logs/error_log
</code>

===Windows with Apache 2.2.11===

Note
* If mod_xebra.so was compiled with VS2008, it has a delay-load dependency on the Visual C++ 9.0 debug runtime library, msvcr90d.dll. This dll comes with Visual Studio 2008 C++ including the free Visual Studio 2008 C++ Express edition. This file can be copied in to the System32 directory. If this DLL is not found you will get an Apache error '''Cannot load C:/Xebra/httpd/modules/mod_xebra.so into server: This application has failed to start because the application configuration is incorrect.'''

* Download apache windows binary from http://httpd.apache.org/download.cgi
* Install (Choose Custom Installation and install Build Headers and Libraries as well)
* Copy $XEBRA_DEV/c_projects/apache_mod_xebra/mod_xebra.so to your Apache2.2\modules folder.
**Note: If you use a newer version of apache than 2.2.11 please compile mod_xebra yourself to avoid any possible errors, see [[Xebra Apache Module Windows]].
* Add the following lines to Apache2.2\conf\httpd.conf:
<code>
#Xebra Module
LoadModule xebra_module modules/mod_xebra.so

<IfModule xebra_module>
AddHandler mod_xebra .xeb
AddHandler mod_xebra .xrpc
XebraServer_port 55001
XebraServer_host "127.0.0.1"
XebraServer_max_upload_size 10000000
XebraServer_upload_path "c:\tmp"
DirectoryIndex index.xeb
<Files ~ "\.(ini|e|ecf)$">
Order allow,deny
Deny from all
</Files>
<Directory ~ "EIFGENs">
Order allow,deny
Deny from all
</Directory>
</IfModule>
</code>
* Also in httpd.conf, change ''DocumentRoot'' to ''{path to xebra}\www'' and don't forget the directory options below the line ''# This should be changed to whatever you set DocumentRoot to.''
* Create the directory ''c:\tmp'' or choose another temp upload directory.
* Restart Apache
* Browse to ''http://localhost/test.xeb''. You should see the a message saying ''Cannot connect to XebraServer. See apache error log.''

===Windows with IIS7===

* Open %XEBRA_DEV%\c_projects\iis_xebra_handler\XebraEventSourceInstaller\XebraEventSourceInstaller.sln in VS2008
* Compile and run (This will install the ''XebraHandler'' source to the Windows Event Log. This cannot be performed by the handler because it lacks permissions.)
* (Optional) Open %XEBRA_DEV%\c_projects\iis_xebra_handler\Xebra.sln in VS2008 and compile
* Create a new site in IIS and point it to %XEBRA_DEV%\www
* Copy %XEBRA_DEV%\c_projects\iis_xebra_handler\website\web.config to %XEBRA_DEV%\www
* Copy %XEBRA_DEV%\c_projects\iis_xebra_handler\website\bin to %XEBRA_DEV%\www

=== Mac OS X with Apache ===
Note:
* If you're using the version of EiffelStudio from MacPorts, environment variables must be set within the startup script. /Applications/MacPorts/Eiffel64/EiffelStudio/Contents/Resources/EiffelLauncher
* Save yourself a ton of hassle and just sudo chmod -R 777 * both the $ISE_EIFFEL and $EIFFEL_SRC directories.

* Get Apache V2 from Mac Ports
sudo port install apache2
* Copy $XEBRA_DEV/www/* to /opt/local/apache2/htdocs
* Compile the module by running
cd $XEBRA_DEV/c_projects/apache_mod_xebra
sudo /opt/local/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 /opt/local/apache2/bin/apxs -i mod_xebra.la
* Prepare to edit the protected httpd.conf file by running the command:
sudo /Applications/TextEdit.app/Contents/MacOS/TextEdit
Within TextEdit, which now is running under sudo, open /opt/local/apache2/conf/httpd.conf
* Add the following lines to /opt/local/apache2/conf/httpd.conf:
<code>
#Xebra Module
LoadModule xebra_module modules/mod_xebra.so

<IfModule xebra_module>
AddHandler mod_xebra .xeb
AddHandler mod_xebra .xrpc
XebraServer_port 55001
XebraServer_host "127.0.0.1"
XebraServer_max_upload_size 10000000
XebraServer_upload_path "/tmp"
DirectoryIndex index.xeb
<Files ~ "\.(ini|e|ecf)$">
Order allow,deny
Deny from all
</Files>
<Directory ~ "EIFGENs">
Order allow,deny
Deny from all
</Directory>
</IfModule>
</code>
* Also in httpd.conf, change ''DocumentRoot'' to ''{path to xebra}\www'' and don't forget the directory options below the line ''# This should be changed to whatever you set DocumentRoot to.''
* Create the directory /tmp or choose another temp upload directory.
* The default MacPorts apache install will listen on port 80
* Restart apache
sudo /opt/local/apache2/bin/apachectl restart
* Browse to http://localhost/test.xeb. You should see a message saying "Cannot connect to XebraServer. See apache error log."
* Hint: keep an eye on the apache error log
tail -f $APACHE2/logs/error_log

==Compile the Translator and Server ==
* First we need to compile the xebra precompile library:

'''Linux'''
<code>
ec -experiment -config $XEBRA_DEV/eiffel_projects/library/xebra_precompile/xebra_precompile.ecf -target xebra_precompile -c_compile -clean -precompile -project_path $XEBRA_DEV/eiffel_projects/library/xebra_precompile
</code>
'''Windows'''
<code>
ec -experiment -config %XEBRA_DEV%\eiffel_projects\library\xebra_precompile\xebra_precompile.ecf -target xebra_precompile -c_compile -clean -precompile -project_path %XEBRA_DEV%\eiffel_projects\library\xebra_precompile
</code>

* Then run:

'''Linux'''
<code>
ec -experiment -config $XEBRA_DEV/eiffel_projects/xebra_translator/xebra_translator.ecf -target xebra_translator -c_compile -clean -finalize -project_path $XEBRA_DEV/eiffel_projects/xebra_translator

ec -experiment -config $XEBRA_DEV/eiffel_projects/xebra_server/xebra_server.ecf -target xebra_server -c_compile -clean -finalize -project_path $XEBRA_DEV/eiffel_projects/xebra_server
</code>
'''Windows'''
<code>
ec -experiment -config %XEBRA_DEV%\eiffel_projects\xebra_translator\xebra_translator.ecf -target xebra_translator -c_compile -clean -finalize -project_path %XEBRA_DEV%\eiffel_projects\xebra_translator

ec -experiment -config %XEBRA_DEV%\eiffel_projects\xebra_server\xebra_server.ecf -target xebra_server -c_compile -clean -finalize -project_path %XEBRA_DEV%\eiffel_projects\xebra_server
</code>

==Test the installation==

To test you installation run

'''Windows'''
%XEBRA_DEV%\apache\bin\httpd.exe
%XEBRA_DEV%\eiffel_projects\xebra_server\EIFGENs\xebra_server\F_code\xebra_server.exe %XEBRA_DEV%\eiffel_projects\xebra_server\config.srv -d 6

'''Linux'''
$XEBRA_DEV/apache/bin/httpd
$XEBRA_DEV/eiffel_projects/xebra_server/EIFGENs/xebra_server/F_code/xebra_server $XEBRA_DEV/eiffel_projects/xebra_server/config.srv -d 6

and then open
http://localhost/helloworld
in your web browser.

The server will then start compiling the xebra precompile library and generate the helloworld webapp. It can take a minute to do so the first time. While compiling you will see a page saying "Application 'helloworld' is compiling...". After a while hit F5 and you should see "Hello WORLD!" (or "Hello world!").

Xebra Installation

2009-09-01T15:15:31Z

Fabioz: /* Ubuntu Installation Script (New) */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

=Installations=
===There are two ways to install Xebra:===
*Automatic
** A script for Ubuntu 9.04 that sets up xebra and also installs apache
** A Windows Installer that contains xebra and apache and sets it up
*Manual (Step-by-step guide)
** Ubuntu 9.04 with Apache
** Windows with Apache
** Windows with IIS7

===A few notes===
*All of xebra is compiled with the -experiment option. We haven't tested to compile anything in non-experimental mode.
*Currently (rev 80407), for all types of installation you have to adapt a files in ISE_LIBRARY to make it work since there is a bug in the eiffel argument parser library: In the class ''ISE_EIFFEL/experimental/library/argument_parser/parsers/argument_base_parser.e'' in the feature ''arguments: ARRAY [STRING]'' replace the line
<code>
create Result.make (1, l_result.count)
</code>
with
<code>
create Result.make_filled ("", 1, l_result.count)
</code>

=Ubuntu Installation Script =
{{Note| This script was tested with Xebra revision 80545, EiffelStudio 6.5.8.294 and Ubuntu 9.04 (August 2009)}}

Run this script (the current revision):
https://svn.eiffel.com/eiffelstudio/trunk/Src/framework/web/xebra/tools/scripts/linux/install_xebra_ubuntu.sh

The script expects $XEBRA_DEV, $ISE_EIFFEL and $ISE_LIBRARY to be set. Please make sure ''svn'', ''wget'', ''vim'' and ''tar'' are installed. Also, the path to your eiffel studio bin folder should be included in your PATH variable.

The script will checkout xebra to $XEBRA_DEV, compile the server and translator, download, install and configure apache to $XEBRA_DEV/apache. Apache will be configured to listen on port 55000 (instead of 80) in order to not interfere with an already installed http server. After the script was successfully run you need to set $XEBRA_LIBRARY to $XEBRA_DEV/library.

To test you installation run
$XEBRA_DEV/bin/launch_apache.sh
$XEBRA_DEV/bin/launch_server.sh
and then browse to
http://localhost:55000/helloworld
The server will then start compiling the xebra precompile library and generate the helloworld webapp. It can take a while to do so the first time (If you want to see what's happening type 'debug_level 6' in the server console). While compiling you will see a page saying "Application 'helloworld' is compiling...". After a while hit F5 and you should see "Hello WORLD!" (or "Hello world!").

=Windows Installer (NEW)=
{{Note| This installer was tested with Xebra revision 80407, EiffelStudio 6.5.8.294, on Windows XP SP2}}

Run the installer at:

https://svn.origo.ethz.ch/eiffelstudio/trunk/Src/framework/web/xebra/tools/installer/win/innosetup/output/XebraSetup.exe

To test your installation click "Launch Xebra Full" in the "Eiffel Xebra" folder in your start menu. This will launch apache and the xebra server and it will open "localhost:55000/helloworld" in your browser.
The server will then start compiling the xebra precompile library and generate the helloworld webapp. It can take a minute to do so the first time (If you want to see what's happening type 'debug_level 6' in the server console). While compiling you will see a page saying "Application 'helloworld' is compiling...". After a while hit F5 and you should see "Hello WORLD!" (or "Hello world!").

=Manual Installation=
This guide expects Eiffel Studio to be installed to $ISE_EIFFEL and the source to be checked out to $EIFFEL_SRC (only the folder 'framework' is needed).

==Checkout Xebra==
* Define $XEBRA_DEV and checkout xebra from https://svn.eiffel.com/eiffelstudio/trunk/Src/framework/web/xebra/ to $XEBRA_DEV
* Define $XEBRA_LIBRARY to $XEBRA_DEV/eiffel_projects/library

==Install HTTP Server==
=== Ubuntu 9.04 with Apache 2.2.11 ===
Note:
* Mod_xebra does currently not run with the apache distribution that comes with ubuntu.

* Download apache unix source from http://httpd.apache.org/download.cgi
* Extract
* Define $APACHE2 where you want to install apache, e.g. to $XEBRA_DEV/apache
* Run the following commands in the extracted folder:
CFLAGS="-ggdb"
./configure --prefix=$APACHE2
make
make install
* Compile the module by running
cd $XEBRA_DEV/c_projects/apache_mod_xebra
$APACHE2/bin/apxs -c mod_xebra.c mod_xebra.h
* Install the module to apache by running
$APACHE2/bin/apxs -i mod_xebra.la
* Add the following lines to $APACHE2/conf/httpd.conf:
<code>
#Xebra Module
LoadModule xebra_module modules/mod_xebra.so

<IfModule xebra_module>
AddHandler mod_xebra .xeb
AddHandler mod_xebra .xrpc
XebraServer_port 55001
XebraServer_host "127.0.0.1"
XebraServer_max_upload_size 10000000
XebraServer_upload_path "/tmp"
DirectoryIndex index.xeb
<Files ~ "\.(ini|e|ecf)$">
Order allow,deny
Deny from all
</Files>
<Directory ~ "EIFGENs">
Order allow,deny
Deny from all
</Directory>
</IfModule>
</code>
* Also in httpd.conf, change ''DocumentRoot'' to ''{path to xebra}\www'' and don't forget the directory options below the line ''# This should be changed to whatever you set DocumentRoot to.''
* Create the directory ''/tmp'' or choose another temp upload directory.
* Restart apache
$APACHE2/bin/apachectl restart
* Browse to ''http://localhost/test.xeb''. You should see a message saying ''Cannot connect to XebraServer. See apache error log.''
* Hint: keep an eye on the apache error log
<code>
tail -f $APACHE2/logs/error_log
</code>

===Windows with Apache 2.2.11===

Note
* If mod_xebra.so was compiled with VS2008, it has a delay-load dependency on the Visual C++ 9.0 debug runtime library, msvcr90d.dll. This dll comes with Visual Studio 2008 C++ including the free Visual Studio 2008 C++ Express edition. This file can be copied in to the System32 directory. If this DLL is not found you will get an Apache error '''Cannot load C:/Xebra/httpd/modules/mod_xebra.so into server: This application has failed to start because the application configuration is incorrect.'''

* Download apache windows binary from http://httpd.apache.org/download.cgi
* Install (Choose Custom Installation and install Build Headers and Libraries as well)
* Copy $XEBRA_DEV/c_projects/apache_mod_xebra/mod_xebra.so to your Apache2.2\modules folder.
**Note: If you use a newer version of apache than 2.2.11 please compile mod_xebra yourself to avoid any possible errors, see [[Xebra Apache Module Windows]].
* Add the following lines to Apache2.2\conf\httpd.conf:
<code>
#Xebra Module
LoadModule xebra_module modules/mod_xebra.so

<IfModule xebra_module>
AddHandler mod_xebra .xeb
AddHandler mod_xebra .xrpc
XebraServer_port 55001
XebraServer_host "127.0.0.1"
XebraServer_max_upload_size 10000000
XebraServer_upload_path "c:\tmp"
DirectoryIndex index.xeb
<Files ~ "\.(ini|e|ecf)$">
Order allow,deny
Deny from all
</Files>
<Directory ~ "EIFGENs">
Order allow,deny
Deny from all
</Directory>
</IfModule>
</code>
* Also in httpd.conf, change ''DocumentRoot'' to ''{path to xebra}\www'' and don't forget the directory options below the line ''# This should be changed to whatever you set DocumentRoot to.''
* Create the directory ''c:\tmp'' or choose another temp upload directory.
* Restart Apache
* Browse to ''http://localhost/test.xeb''. You should see the a message saying ''Cannot connect to XebraServer. See apache error log.''

===Windows with IIS7===

* Open %XEBRA_DEV%\c_projects\iis_xebra_handler\XebraEventSourceInstaller\XebraEventSourceInstaller.sln in VS2008
* Compile and run (This will install the ''XebraHandler'' source to the Windows Event Log. This cannot be performed by the handler because it lacks permissions.)
* (Optional) Open %XEBRA_DEV%\c_projects\iis_xebra_handler\Xebra.sln in VS2008 and compile
* Create a new site in IIS and point it to %XEBRA_DEV%\www
* Copy %XEBRA_DEV%\c_projects\iis_xebra_handler\website\web.config to %XEBRA_DEV%\www
* Copy %XEBRA_DEV%\c_projects\iis_xebra_handler\website\bin to %XEBRA_DEV%\www

=== Mac OS X with Apache ===
Note:
* If you're using the version of EiffelStudio from MacPorts, environment variables must be set within the startup script. /Applications/MacPorts/Eiffel64/EiffelStudio/Contents/Resources/EiffelLauncher
* Save yourself a ton of hassle and just sudo chmod -R 777 * both the $ISE_EIFFEL and $EIFFEL_SRC directories.

* Get Apache V2 from Mac Ports
sudo port install apache2
* Copy $XEBRA_DEV/www/* to /opt/local/apache2/htdocs
* Compile the module by running
cd $XEBRA_DEV/c_projects/apache_mod_xebra
sudo /opt/local/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 /opt/local/apache2/bin/apxs -i mod_xebra.la
* Prepare to edit the protected httpd.conf file by running the command:
sudo /Applications/TextEdit.app/Contents/MacOS/TextEdit
Within TextEdit, which now is running under sudo, open /opt/local/apache2/conf/httpd.conf
* Add the following lines to /opt/local/apache2/conf/httpd.conf:
<code>
#Xebra Module
LoadModule xebra_module modules/mod_xebra.so

<IfModule xebra_module>
AddHandler mod_xebra .xeb
AddHandler mod_xebra .xrpc
XebraServer_port 55001
XebraServer_host "127.0.0.1"
XebraServer_max_upload_size 10000000
XebraServer_upload_path "/tmp"
DirectoryIndex index.xeb
<Files ~ "\.(ini|e|ecf)$">
Order allow,deny
Deny from all
</Files>
<Directory ~ "EIFGENs">
Order allow,deny
Deny from all
</Directory>
</IfModule>
</code>
* Also in httpd.conf, change ''DocumentRoot'' to ''{path to xebra}\www'' and don't forget the directory options below the line ''# This should be changed to whatever you set DocumentRoot to.''
* Create the directory /tmp or choose another temp upload directory.
* The default MacPorts apache install will listen on port 80
* Restart apache
sudo /opt/local/apache2/bin/apachectl restart
* Browse to http://localhost/test.xeb. You should see a message saying "Cannot connect to XebraServer. See apache error log."
* Hint: keep an eye on the apache error log
tail -f $APACHE2/logs/error_log

==Compile the Translator and Server ==
* First we need to compile the xebra precompile library:

'''Linux'''
<code>
ec -experiment -config $XEBRA_DEV/eiffel_projects/library/xebra_precompile/xebra_precompile.ecf -target xebra_precompile -c_compile -clean -precompile -project_path $XEBRA_DEV/eiffel_projects/library/xebra_precompile
</code>
'''Windows'''
<code>
ec -experiment -config %XEBRA_DEV%\eiffel_projects\library\xebra_precompile\xebra_precompile.ecf -target xebra_precompile -c_compile -clean -precompile -project_path %XEBRA_DEV%\eiffel_projects\library\xebra_precompile
</code>

* Then run:

'''Linux'''
<code>
ec -experiment -config $XEBRA_DEV/eiffel_projects/xebra_translator/xebra_translator.ecf -target xebra_translator -c_compile -clean -finalize -project_path $XEBRA_DEV/eiffel_projects/xebra_translator

ec -experiment -config $XEBRA_DEV/eiffel_projects/xebra_server/xebra_server.ecf -target xebra_server -c_compile -clean -finalize -project_path $XEBRA_DEV/eiffel_projects/xebra_server
</code>
'''Windows'''
<code>
ec -experiment -config %XEBRA_DEV%\eiffel_projects\xebra_translator\xebra_translator.ecf -target xebra_translator -c_compile -clean -finalize -project_path %XEBRA_DEV%\eiffel_projects\xebra_translator

ec -experiment -config %XEBRA_DEV%\eiffel_projects\xebra_server\xebra_server.ecf -target xebra_server -c_compile -clean -finalize -project_path %XEBRA_DEV%\eiffel_projects\xebra_server
</code>

==Test the installation==

To test you installation run

'''Windows'''
%XEBRA_DEV%\apache\bin\httpd.exe
%XEBRA_DEV%\eiffel_projects\xebra_server\EIFGENs\xebra_server\F_code\xebra_server.exe %XEBRA_DEV%\eiffel_projects\xebra_server\config.srv -d 6

'''Linux'''
$XEBRA_DEV/apache/bin/httpd
$XEBRA_DEV/eiffel_projects/xebra_server/EIFGENs/xebra_server/F_code/xebra_server $XEBRA_DEV/eiffel_projects/xebra_server/config.srv -d 6

and then open
http://localhost/helloworld
in your web browser.

The server will then start compiling the xebra precompile library and generate the helloworld webapp. It can take a minute to do so the first time. While compiling you will see a page saying "Application 'helloworld' is compiling...". After a while hit F5 and you should see "Hello WORLD!" (or "Hello world!").

Xebra Documentation

2009-09-01T00:34:17Z

Fabioz: /* Howto's */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

=Overview=
* [[Xebra Socket Communication]]

=Xebra HTTP Server Plugins=
* [[Xebra Module Communication Protocol|Module Communication Protocol]]
* [[Xebra Module Content Types|Content Types]]

==Mod_xebra for Apache==
* [[Xebra Apache Module Windows|Apache Module Windows]]

=Xebra Server=
* [[Xebra Server Administration]]

= Web Applications =
* [[Xebra Webapp Config File]]

==Xebra Tag Libraries==
On the following pages you can find the descriptions of the different tags of the available tag libraries.
* [[Xebra Taglib Page|Page]]
* [[Xebra Taglib Xeb|Xeb]]
* [[Xebra Taglib Form|Form]]
* [[Xebra Taglib XRPC|XRPC]]
* [[Xebra Tag Attribute|Tag Attribute]]

==Master pages==
* [[Xebra Master Pages|Templates with master pages]]

==XML_RPC==
* [[Xebra XML_RPC]]

=Code documentation=
==Xebra Libraries==
=== Thread Utilities ===
An implementation of a [http://en.wikipedia.org/wiki/Thread_pool_pattern| Thread Pool]. There are two implementations: with or without data class reuse (DATA_THREAD_POOL and THREAD_POOL).

=== Xebra AST Elements ===
This library contains various classes which model eiffel language constructs. It consists of classes, features, comments, locals and expressions. They can be combined to build an object model of an eiffel class. Convenience features are provided to add locals and variables with unique names.
AST Elements can be serialized to a text representation.
It also contains some specialized classes for Xebra.

=== Xebra Common ===

Xebra_common contains all commands, command responses and interfaces for commands that are used by the server and the webapps. Furthermore, it contains deferred classes for server modules and webapp config classes.

=== Xebra Error===
Provides internal error types for all xebra applications such as XERROR_CANNOT_OPEN_FILE or XERROR_SOCKET_NOT_BOUND. These errors are not supplied to the browser but only displayed in the log/console.

=== Xebra Error Responses ===
Classes from xebra_error_responses are split into XER_SERVER: error responses generated by the server and XER_APP: error responses generated by the webapp. Both types are ultimately sent to the http server plugin and displayed in the user's browser. For instance XER_POST_TOO_BIG is a server error response that is created if the post request is bigger than allowed. XER_APP_CANNOT_FIND_PAGE is a response created by the webapp and then sent to the server if no servlet with the specified name was defined.

=== Xebra Http ===

Xebra_http provides classes for cookies, html requests, html responses, sessions and their parsers.

=== Xebra Taglibrary Base ===
The base tag library contains all the basic Xebra tag implementations like display, call and iterate. For a more detailed explanation of the tags see [[Xebra_Taglib_Xeb| the documentation]].

=== Xebra Taglibrary Form ===
The form tag library contains all tag implementations for form related tags. Automatic wrapping of values, controls and validations are included in this library. For a more detailed explanation see [[Xebra_Taglib_Form|here]].

=== Xebra Taglibrary XRPC ===
This tag library contains tags for XML-RPC applications. For further information see [[Xebra_Taglib_XRPC|here]].

=== Xebra Utilities ===

Xebra_utilities is a collection of independent helper classes such as text escaper, file utilities, log outputter, stopwatch, string expander etc.

=== Xebra Tags ===
Contains all super classes used for xebra tags and xebra tag arguments. Also contains super classes for servlet generation (XGEN_SERVLET_GENERATOR).

===Xebra Web Application===

Provides all necessary base classes such as XWA_SERVLET, XWA_CONTROLLER, XWA_APPLICATION to webapp applications. Takes care of communication with server.

= Other =
== Howtos ==
===Build Windows Installer===

* Install apache (c:\apache)
*Visual Build Professional 7:
**Open xebra\tools\installer\win\XebraBuild.bld
**Adapt Macro->Project variables to match your system (APACHE, ROOT)
**Run
*Inno Setup 5 Compiler
**Open xebra\tools\installer\win\innosetup\xebra_install_test.iss
**Generate new AppId
**Changed AppVersion
**Check that LicenseFile file exists (gnu licence?)
**Check Source files are correct folder
**Build

Xebra Documentation

2009-09-01T00:27:35Z

Fabioz:

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

=Overview=
* [[Xebra Socket Communication]]

=Xebra HTTP Server Plugins=
* [[Xebra Module Communication Protocol|Module Communication Protocol]]
* [[Xebra Module Content Types|Content Types]]

==Mod_xebra for Apache==
* [[Xebra Apache Module Windows|Apache Module Windows]]

=Xebra Server=
* [[Xebra Server Administration]]

= Web Applications =
* [[Xebra Webapp Config File]]

==Xebra Tag Libraries==
On the following pages you can find the descriptions of the different tags of the available tag libraries.
* [[Xebra Taglib Page|Page]]
* [[Xebra Taglib Xeb|Xeb]]
* [[Xebra Taglib Form|Form]]
* [[Xebra Taglib XRPC|XRPC]]
* [[Xebra Tag Attribute|Tag Attribute]]

==Master pages==
* [[Xebra Master Pages|Templates with master pages]]

==XML_RPC==
* [[Xebra XML_RPC]]

=Code documentation=
==Xebra Libraries==
=== Thread Utilities ===
An implementation of a [http://en.wikipedia.org/wiki/Thread_pool_pattern| Thread Pool]. There are two implementations: with or without data class reuse (DATA_THREAD_POOL and THREAD_POOL).

=== Xebra AST Elements ===
This library contains various classes which model eiffel language constructs. It consists of classes, features, comments, locals and expressions. They can be combined to build an object model of an eiffel class. Convenience features are provided to add locals and variables with unique names.
AST Elements can be serialized to a text representation.
It also contains some specialized classes for Xebra.

=== Xebra Common ===

Xebra_common contains all commands, command responses and interfaces for commands that are used by the server and the webapps. Furthermore, it contains deferred classes for server modules and webapp config classes.

=== Xebra Error===
Provides internal error types for all xebra applications such as XERROR_CANNOT_OPEN_FILE or XERROR_SOCKET_NOT_BOUND. These errors are not supplied to the browser but only displayed in the log/console.

=== Xebra Error Responses ===
Classes from xebra_error_responses are split into XER_SERVER: error responses generated by the server and XER_APP: error responses generated by the webapp. Both types are ultimately sent to the http server plugin and displayed in the user's browser. For instance XER_POST_TOO_BIG is a server error response that is created if the post request is bigger than allowed. XER_APP_CANNOT_FIND_PAGE is a response created by the webapp and then sent to the server if no servlet with the specified name was defined.

=== Xebra Http ===

Xebra_http provides classes for cookies, html requests, html responses, sessions and their parsers.

=== Xebra Taglibrary Base ===
The base tag library contains all the basic Xebra tag implementations like display, call and iterate. For a more detailed explanation of the tags see [[Xebra_Taglib_Xeb| the documentation]].

=== Xebra Taglibrary Form ===
The form tag library contains all tag implementations for form related tags. Automatic wrapping of values, controls and validations are included in this library. For a more detailed explanation see [[Xebra_Taglib_Form|here]].

=== Xebra Taglibrary XRPC ===
This tag library contains tags for XML-RPC applications. For further information see [[Xebra_Taglib_XRPC|here]].

=== Xebra Utilities ===

Xebra_utilities is a collection of independent helper classes such as text escaper, file utilities, log outputter, stopwatch, string expander etc.

=== Xebra Tags ===
Contains all super classes used for xebra tags and xebra tag arguments. Also contains super classes for servlet generation (XGEN_SERVLET_GENERATOR).

===Xebra Web Application===

Provides all necessary base classes such as XWA_SERVLET, XWA_CONTROLLER, XWA_APPLICATION to webapp applications. Takes care of communication with server.

= Other =
== Howto's ==
===Build Windows Installer===

* Install apache (c:\apache)
*Visual Build Professional 7:
**Open xebra\tools\installer\win\XebraBuild.bld
**Adapt Macro->Project variables to match your system (APACHE, ROOT)
**Run
*Inno Setup 5 Compiler
**Open xebra\tools\installer\win\innosetup\xebra_install_test.iss
**Generate new AppId
**Changed AppVersion
**Check that LicenseFile file exists (gnu licence?)
**Check Source files are correct folder
**Build

Xebra Create Webapps

2009-09-01T00:07:28Z

Fabioz: /* Create a new webapp */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

=Create a new webapp=

# Setup an initial Eiffel project for your webapp. For that matter you can use this [https://svn.eiffel.com/eiffelstudio/trunk/Src/framework/web/xebra/tools/scripts/linux/create_website.sh script] which creates all necessary files. Make sure to assign a free port to your webapp (see also [[Xebra Webapp Config File]]). The webapp has to be created in the same folder that is specified in the servers config file at webapps_root. See [[Xebra Server Config File]] for more information.
# Run the server (see [[Xebra Server Administration]]) and browse to http://localhost:55000/yourwebapp. The server will translate and compile your webapp. Once compiled, you should see a page displaying "Yourwebapp works!".
# Create xeb files for your webapp. See [[Xebra Documentation|Xebra Tag Libraries]] for more info about xeb tags (see also [[Xebra Write Xeb File | Tutorial]]). Note that you have to let the server re-translate your webapp everytime you change xeb-files or add new xeb-files. This can be done by just pressing F5 in the browser. The server automatically detects that the webapp has to be re-translated if it is set to Development Mode (see [[Xebra Server Administration]] for more info).
# Create the eiffel classes.

=Add support for XML-RPC=
* [[Xebra Create XML-RPC Webapp]]

=Manually translate a webapp=
To manually translate, generate and compile your webapp use the following commands

Linux
<code>
cd $XEBRA_DEV/httpd/htdocs/yourwebapp/

#Translate
$XEBRA_DEV/eiffel_projects/xebra_translator/EIFGENs/xebra_translator/W_code/xebra_translator -n yourwebapp -i . -o . -l $XEBRA_DEV/eiffel_projects/xebra_translator

#Compile servlet_gen
ec -experiment -config .generated/servlet_gen/servlet_gen.ecf -target servlet_gen -c_compile -stop

#Execute servlet_gen
.generated/servlet_gen/EIFGENs/servlet_gen/W_code/servlet_gen -o .

#Compile webapp
ec -experiment -config yourwebapp.ecf -target yourwebapp -c_compile -stop
</code>

Windows
<code>
cd %XEBRA_DEV%\httpd\htdocs\yourwebapp\

#Translate
%XEBRA_DEV%\eiffel_projects\xebra_translator\EIFGENs\xebra_translator\W_code\xebra_translator -n yourwebapp -i . -o . -l %XEBRA_DEV%\eiffel_projects\xebra_translator

#Compile servlet_gen
ec -experiment -config .generated\servlet_gen\servlet_gen.ecf -target servlet_gen -c_compile -stop

#Execute servlet_gen
.generated\servlet_gen\EIFGENs\servlet_gen\W_code\servlet_gen.exe .

#Compile webapp
ec -experiment -config yourwebapp.ecf -target yourwebapp -c_compile -stop
</code>

Optionally, you can add the "-clean" option for ec and the "-f" option for translator to force a complete recompilation.

Xebra Tutorial

2009-08-31T21:28:14Z

Fabioz:

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

=Server=
* Run Xebra Server: [[Xebra Server Administration]]

=Webapp=
* Create a webapp: [[Xebra Create Webapps|Create Webapps]]
* Debug a webapp: [[Xebra Debug Webapp|Debug Webapp]]
* Write a xeb file: [[Xebra Write Xeb File|Write Xeb File]]
* Add XML-RPC support (currently not available): [[Xebra Create XML-RPC Webapp]]

=Extend Xebra=
*Create your own tag libraries: [[Xebra Create Tag Library|Create custom tag library]]

=Apache=

Xebra Documentation

2009-08-31T18:08:07Z

Fabioz: /* Xebra Taglibrary XRPC */

[[Category:Xebra]]
[[Xebra About|About]] | [[Xebra Installation|Installation]] | [[Xebra Documentation|Documentation]] | [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]

=Overview=
* [[Xebra Socket Communication]]

=Xebra HTTP Server Plugins=
* [[Xebra Module Communication Protocol|Module Communication Protocol]]
* [[Xebra Module Content Types|Content Types]]

==Mod_xebra for Apache==
* [[Xebra Apache Module Windows|Apache Module Windows]]

=Xebra Server=
* [[Xebra Server Administration]]

= Web Applications =
* [[Xebra Webapp Config File]]

==Xebra Tag Libraries==
On the following pages you can find the descriptions of the different tags of the available tag libraries.
* [[Xebra Taglib Page|Page]]
* [[Xebra Taglib Xeb|Xeb]]
* [[Xebra Taglib Form|Form]]
* [[Xebra Taglib XRPC|XRPC]]
* [[Xebra Tag Attribute|Tag Attribute]]

==Master pages==
* [[Xebra Master Pages|Templates with master pages]]

==XML_RPC==
* [[Xebra XML_RPC]]

=Code documentation=
==Xebra Libraries==
=== Thread Utilities ===
An implementation of a [http://en.wikipedia.org/wiki/Thread_pool_pattern| Thread Pool]. There are two implementations: with or without data class reuse (DATA_THREAD_POOL and THREAD_POOL).

=== Xebra AST Elements ===
This library contains various classes which model eiffel language constructs. It consists of classes, features, comments, locals and expressions. They can be combined to build an object model of an eiffel class. Convenience features are provided to add locals and variables with unique names.
AST Elements can be serialized to a text representation.
It also contains some specialized classes for Xebra.

=== Xebra Common ===

Xebra_common contains all commands, command responses and interfaces for commands that are used by the server and the webapps. Furthermore, it contains deferred classes for server modules and webapp config classes.

=== Xebra Error===
Provides internal error types for all xebra applications such as XERROR_CANNOT_OPEN_FILE or XERROR_SOCKET_NOT_BOUND. These errors are not supplied to the browser but only displayed in the log/console.

=== Xebra Error Responses ===
Classes from xebra_error_responses are split into XER_SERVER: error responses generated by the server and XER_APP: error responses generated by the webapp. Both types are ultimately sent to the http server plugin and displayed in the user's browser. For instance XER_POST_TOO_BIG is a server error response that is created if the post request is bigger than allowed. XER_APP_CANNOT_FIND_PAGE is a response created by the webapp and then sent to the server if no servlet with the specified name was defined.

=== Xebra Http ===

Xebra_http provides classes for cookies, html requests, html responses, sessions and their parsers.

=== Xebra Taglibrary Base ===
The base tag library contains all the basic Xebra tag implementations like display, call and iterate. For a more detailed explanation of the tags see [[Xebra_Taglib_Xeb| the documentation]].

=== Xebra Taglibrary Form ===
The form tag library contains all tag implementations for form related tags. Automatic wrapping of values, controls and validations are included in this library. For a more detailed explanation see [[Xebra_Taglib_Form|here]].

=== Xebra Taglibrary XRPC ===
This tag library contains tags for XML-RPC applications. For further information see [[Xebra_Taglib_XRPC|here]].

=== Xebra Utilities ===

Xebra_utilities is a collection of independent helper classes such as text escaper, file utilities, log outputter, stopwatch, string expander etc.

=== Xebra Tags ===
Contains all super classes used for xebra tags and xebra tag arguments. Also contains super classes for servlet generation (XGEN_SERVLET_GENERATOR).

===Xebra Web Application===

Provides all necessary base classes such as XWA_SERVLET, XWA_CONTROLLER, XWA_APPLICATION to webapp applications. Takes care of communication with server.