We reserve all rights in this document and in the information contained therein. Reproduction,use or disclosure to third parties without express authority is strictly forbidden. Ó ABB Process Industries; 2002
Matlab Web Server Installation and Configuration Guide
1. Introduction 3
2. Product Requirements 3
2.1 Web Requirements 3
2.1.1 Web Browser 3
2.1.2 Web Server 3
3. Configuration 3
3.1 Matlab Web Server Installation 3
3.2 Matlab Web Server Setup 4
3.2.1 Matweb.conf 4
3.2.2 Matlabserver.conf 4
3.3 Apache Installation 5
3.4 Apache Setup 5
4. Additional Configuration 6
4.1 PHP Installation 6
4.2 PHP Setup 6
5. Tested program versions 7
6. References 7
This guide covers installation of Matlab Web Server on IBM PC compatible computers running Microsoft Windows NT.
The Matlab Web Server has the same supporting hardware and software requirements as Matlab itself, except for memory required. Look in the Matlab Installation Guidefor hardware and software requirements.
Memory requirements while running the Matlab Web Server vary with the number of Matlabs configured. Each Matlab running under the Matlab Web Server consumes 256 KB of memory.
The Matlab Web Server requires Matlab Release 11 or later and that TCP/IP networking software must be installed on the computer.
A Web browser suitable for your platform must be installed to submit input and receive output from the Matlab Web Server. Netscape Communicator Release 4.7 and Microsoft Internet Explorer 5.0 have been tested with current Matlab Web Server.
Web server software (HTTPD or similar) capable of running Common Gateway Interface (CGI) need to be installed on the system where Matlab is running or on a machine that has network access to the machine where Matlab is running.
The free software used in this configuration is the Apache web server .
This part describes how to setup and configure the Matlab Web Server on Windows NT, and how to configure it with Apache web server.
3.1Matlab Web Server Installation
Note When installing Matlab Web Server and Apache make sure that the directories where the software are installed DON’T INCLUDE ANY SPACES IN THE PATH NAMES.
Follow the normal Matlab installation procedure for your platform, as documented in
Matlab Installation Guide to install the Matlab Web Server. Select the Matlab Web Server choice when it appears during the installation.
Before it is possible to run Matlab Web Server applications a web server, such as Apache, need to be installed and configured. This web server will regulate communication between Matlab and the web browser (Netscape or Explorer).
3.2Matlab Web Server Setup
Note The notation represent the Matlab root directory, the directory where Matlab is installed on the system.
The file matweb.conf is the Matlab Web Server configuration file. It is by default located in the /toolbox/webserver/wsdemos directory. Open the file in a text editor and replace the notation with the name of the root directory where Matlab is installed.
If an application creates graphic files, there must be provided for a location where Matlab can write these for Apache server access, e.g /icons (see Apache Setup). Applications are delineated by the main application entry point name (M-file) in square brackets . The mldir entry associated with each application in the matweb.conf file indicates the location to Matlab.
Mldir= /toolbox/webserver/wsdemos Also, replace matlabserver_host_name with the TCP/IP hostname of the machine. If the Matlab Web Server is installed locally the hostname should be localhost (or 127.0.0.1).
The installation procedure creates the file matlabserver.conf. The file is by default located in /webserver/matlabserver.conf. The file contains the notation:
-m 1 This number represents the number of Matlabs that can run concurrently. After testing that everything is working properly, you can change this number to something more convenient. To see any changes made to matlabserver.conf, the Matlab Web Server must be stopped and restarted.
Download the most recent version of Apache for Windows on:
Download the file named apache_1.3.22-win32_nosrc-r2.msi or similar.
To install msi package it is required that Microsoft Installer is present. If it is not installed on the computer, download it from http://httpd.apache.org/dist/httpd/binaries/win32/
and install it.
It is recommended that Apache is installed as a service, in this way it will automatically start when the machine boots and keep it running when logging off.
Before it is possible to use Matlab Web Server with Apache some smaller changes are needed to the Apache configuration file called httpd.conf. The location of the file is in the conf folder under the path selected for installation.
Open the file in a text editor and make the following changes in the file.
DocumentRoot “/toolbox/webserver/wsdemos” Change the “Directory” to whatever the “DocumentRoot” is set to:
/toolbox/webserver/wsdemos”> The Matlab Web Server examples that follow the product will try to show all images in the /toolbox/webserver/wsdemos directory. The examples html-files calls the alias /icons/ directory. To be able to see the images in the web browser, an alias for the /icons/ directory is needed. Change that line to:
Alias /icons/ “/toolbox/webserver/wsdemos” Also change the directory to:
/toolbox/webserver/wsdemos”> Finally, change the script alias directory. This controls which directories that contain server scripts. Change the line:
ScriptAlias /cgi-bin/ “/toolbox/webserver/wsdemos” Also change the directory to:
Now it is necessary to restart the Apache Web Server.
A PHP installation is needed if PHP-script is used in the Matlab Web Server applications (e.g in the HTML code).
Download the most recent version of PHP for Windows on:
Extract the distribution file to a directory.
This part explains how to set up PHP in order to use Apache module dll.
It is needed to ensure that the dlls that PHP uses can be found. The precise dlls involved depend on the web server in use and if PHP is running as a CGI or as a server module. Php4ts.dll is always needed. Relevant DLL from the sapi folder is also needed. If any PHP extension DLLs are used then they are needed as well. To make sure that the DLLs can be found, copy them to the system directory (e.g winnt/systm32).
Copy php4ts.dll and all all .dll-files under the dll folder to winnt/system32 There are two ini-files, php.ini-dist and php.ini-recommended, distributed with the PHP installation. The latter is recommended.
Copy php.ini-recommended to the system directory (e.g winnt) and rename it to php.ini. Edit the new php.ini file. Set the root of the PHP pages to:
Doc_root=”/toolbox/webserver/wsdemos” Also change the ‘extension_dir’ setting to point to where the ‘php_*.dll’ files are placed:
Extension_dir = “C:/php/extensions” A few changes are required in the Apache configuration file:
LoadModule php4_module c:/php/sapi/php4apache.dll AddType application/x-httpd-php .php .phtml In Apache 1.3.22 for Windows, the Apache default configuration file has a ClearModuleList directive included by default. If this directive is used, it is required to put an AddModule mod_php4.c to the AddModule list, as else PHP will not be registered as an Apache module.