Xitami Webserver

Xitami v2.25 beta 5 patch 1 which fixes the VHost-Bug again.

Xitami for OS/2 The OS/2 version of Xitami was built using GCC 2.7.2.1 and runs with the EMX 0.9c environment. The EMX DLLs will be required, and are available from fine FTP sites everywhere (e.g. ftp.leo.org, ftp.cdrom.com, hobbes.nmsu.edu). Compiled with assertions and gdb debugging information disabled. The OS/2 version of Xitami was built by Ewen McNeill who also ported SFL and SMT to OS/2. The current distribution of Xitami for OS/2 was built for EMX 0.9c fix 2, and will work with releases up to EMX 0.9c fix 4. Download the OS/2 binary package -- you'll need an unzip tool to extract the archive. You can also build the server from the Windows source package, using the supplied xibuild.cmd file. To install an Desktop icon for Xitami, run install.cmd. When you have installed Xitami, run xitami.exe, then connect with any web browser. You should see the "Welcome To Xitami" test page. If Xitami cannot run on its normal port (80), it shows an error message: this can happen if another server is using port 80. To use an alternative HTTP port, use the '-b' option. This shifts the standard HTTP and FTP ports by some 'base'. For example, '-b 5000' runs the Xitami HTTP service on port 5080 and the FTP service on port 5021. You would then connect using http://localhost:5080/. To halt Xitami, press Ctrl-C. This shuts-down the server cleanly. Using TCP/IP With OS/2 OS/2 Warp Connect and OS/2 Warp 4 (Merlin) are set-up for network-based (LAN) TCP/IP automatically. In those cases it is just a matter of enabling the loop-back connection, which can be done in the TCP/IP configuration page, and then the address http://127.0.0.1/ can be used to access pages on the same system. With OS/2 Warp 3 (i.e. not the connect version) only serial-based TCP/IP is supplied but the loop-back connection can be enabled using the ifconfig command: ifconfig lo 127.0.0.1 up With OS/2 2.x there is no TCP/IP software supplied by default. However, there is an extra package available from IBM (even today, we think), which adds TCP/IP networking. OS/2 1.x (16 bit code) doesn't support TCP/IP at all as far as we know. In all cases where TCP/IP is bundled with OS/2, it is an installation option. Obviously the TCP/IP software must be installed to use TCP/IP-based programs like Xitami. As far as we know, OS/2 can be used without a nameserver available (we use a Linux machine as the nameserver for our network), if a 'hosts' file is set up in the %ETC% directory (i.e. the directory pointed at by the ETC environment variable. This directory is typically d:\tcpip\etc, or d:\mptn\etc, where d: is the boot drive). The 'hosts' file should contain the normal host information, i.e. the IP address, and then the name associated with that IP address, on the same line separated by (one or more) spaces. OS/2 can be told to use the hosts file before checking DNS by setting the environment variable; set this line in config.sys and reboot: USE_HOSTS_FIRST=1 Configuring The EMX System The default number of file handles for an EMX is around 20-40. This is too little for a heavily-used server, and you may get errors logged as "out of file handles". The number of file handles available in programs that use EMX can be controlled via a runtime settable environment variable, EMXOPT. From the EMX runtime documentation (emxrt.doc): 7 emx options ============= You can customize emx by setting the EMXOPT environment variable. This environment variable contains a list of options, similar to command line options. The options must be separated by at least one blank. Example: set emxopt=-c -h40 7.1 emx options (OS/2) ---------------------- -c Disable core dumps caused by signals and exceptions -h# Set OS/2 file handle limit to #. The number # must be between 10 and 65536 [...] For a busy web server, a good value would be 120: set EMXOPT=-h120 Source Installation For OS/2 With the EMX development system (including the GNU C compiler) you can rebuild Xitami on your OS/2 system. You must have installed EMX (we recommend version 0.9c) including these packages: emxrt.zip, bsddev.zip, gnudev1.zip, gnudev2.zip, emxdev1.zip, emxdev2.zip. To rebuild Xitami, first unzip the source package in a suitable directory, e.g. C:\Xitami. This creates a source tree and also installs the various files and subdirectories that are needed for running Xitami. The sources are in src\sfl and src\smt. You can build the executable using the command file 'xibuild'. If this fails, for some reason, you must build SFL and SMT manually, but this is fairly simple: Open an OS/2 command window and cd to src\sfl, and type the command 'build'. If all goes well, this will compile the SFL library, and link a number of test programs. The two files that you really need are libsfl.a (or libsfl.lib, depending on how EMX is configured) and sfl.h. Copy these two files into src\smt. Now type 'build' in that directory too. This creates a number of files, but the two you really need are xitami.exe and xixlat.exe. Copy these two files into .... (the main Xitami directory). You can now type 'xitami' to start the web server. Copyright © 1996-99 iMatix Corporation

LICENSE AGREEMENT This license agreement covers your use of the iMatix XITAMI web server, its source code, documentation, and executable files, hereinafter referred to as "the Product". The Product is Copyright (c) 1991-97 iMatix. You may use it and distribute it according to this following License Agreement. If you do not agree with these terms, please remove the Product from your system. By incorporating the Product in your work or distributing the Product to others you implicitly agree to these license terms. This License Agreement covers the current version of The Product. iMatix reserves the right to modify the terms of this License Agreement at any moment, and without prior notification, in future releases of The Product. STATEMENT OF COPYRIGHT The Product is, and remains, copyright 1991-97 iMatix, with exception of specific copyrights as noted in the individual source files. CONDITIONS OF USE The Product is provided in two forms: as a ready-to-run installation kit consisting of executable programs, help files, etc. (the "Product Executable") and as a package of source files, the "Product Sources". You may freely use and distribute the Product Executable so long as you provide the complete and unmodified original Product Executable installation kit as supplied by iMatix. The Product Sources fall under the License Agreement for the iMatix SMT product. The applicable terms and conditions are repeated here. You may freely and at no cost use the Product Sources in any project, commercial, academic, military, governmental, or private, so long as you respect the License Agreement. The License Agreement does not affect any software except the Product. In particular, any application that uses the Product does not itself fall under the License Agreement. You may modify any part of the Product, including sources and documentation, except this License Agreement, which you may not modify. You must clearly indicate any modifications at the start of each source file. The user of any modified Product code must know that the source file is not original. At your discretion, you may rewrite or reuse any part of the Product so that your derived code is not obviously part of the Product. This derived code does not fall under the Product License Agreement directly, but you must include a credit at the start of each source file indicating the original authorship and source of the code, and a statement of copyright as follows: "Parts copyright (c) 1991-97 iMatix." You do not need to provide the source code for the Product as part of your product. However, you must do one of these things to comply with the Product License Agreement: 1. Provide the source code for Product modules that you use, or 2. Make your product freely available according to a license similar to the GNU General Public License, or the Perl Artistic License, or 3. Add this phrase to the documentation for your product: "This product uses parts of the SMT Kernel, Copyright (c) 1991-97 iMatix <http://www.imatix.com>". DISCLAIMER OF WARRANTY The Product is provided as free software, in the hope that it will be useful. It is provided "as-is", without warranty of any kind, either expressed or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. The entire risk as to the quality and performance of the Product is with you. Should the Product prove defective, the full cost of repair, servicing, or correction lies with you. TECHNICAL SUPPORT Limited technical support can be had from support@imatix.com. Full guaranteed technical support is subject to an iMatix support license: current prices and conditions are shown on the imatix.com website. OTHER LICENSING CONDITIONS For commercial distributors, other licensing conditions may be negotiated with respect to technical support and redistribution rights. Published by iMatix http://www.imatix.com 17 March, 1997