Matlab Web Server Installation and Configuration Guide

Transcription

1 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 Product Requirements Web Requirements Web Browser Web Server Configuration Matlab Web Server Installation Matlab Web Server Setup Matweb.conf Matlabserver.conf Apache Installation Apache Setup Additional Configuration PHP Installation PHP Setup Tested program versions References... 6 Type des. Prep. / Doc.kind Installation Instruction No. of p. Appr. / Resp.dept. Part no. Title Matlab Web Server Installation and Configuration Guide for E-DDA ABB Process Industries en 1 FILE: TR0224installation_guide.doc; TEMPLATE: TECHN_DOC_STAND_P.dot R0; SKELETON: ; SAVEDATE: 3/19/2002 4:22 PM 7

2 1. Introduction This guide covers installation of Matlab Web Server on IBM PC compatible computers running Microsoft Windows NT. 2. Product Requirements The Matlab Web Server has the same supporting hardware and software requirements as Matlab itself, except for memory required. Look in the Matlab Installation Guide[1] for 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. 2.1 Web Requirements Web Browser 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 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 [2]. 3. Configuration 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.1 Matlab 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. ABB Process Industries en 2

3 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.2 Matlab Web Server Setup Note The notation <matlab> represent the Matlab root directory, the directory where Matlab is installed on the system Matweb.conf The file matweb.conf is the Matlab Web Server configuration file. It is by default located in the <Matlab>/toolbox/webserver/wsdemos directory. Open the file in a text editor and replace the notation <matlab> 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. [testfile] Mldir= <Matlab>/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 ). Mlserver=localhost Matlabserver.conf The installation procedure creates the file matlabserver.conf. The file is by default located in <Matlab>/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. ABB Process Industries en 3

4 3.3 Apache Installation Download the most recent version of Apache for Windows on: Download the file named apache_ 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 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. 3.4 Apache Setup 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. Change the DocumentRoot directory to your Matlab Web Server directory DocumentRoot <Matlab>/toolbox/webserver/wsdemos Change the Directory to whatever the DocumentRoot is set to: <Directory <Matlab>/toolbox/webserver/wsdemos > The Matlab Web Server examples that follow the product will try to show all images in the <Matlab>/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/ <Matlab>/toolbox/webserver/wsdemos Also change the directory to: <Directory <Matlab>/toolbox/webserver/wsdemos > Finally, change the script alias directory. This controls which directories that contain server scripts. Change the line: ScriptAlias /cgi-bin/ <Matlab>/toolbox/webserver/wsdemos Also change the directory to: <Directory <Matlab>/toolbox/webserver/wsdemos > Now it is necessary to restart the Apache Web Server. ABB Process Industries en 4

5 4. Additional Configuration 4.1 PHP Installation 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. 4.2 PHP Setup 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= <Matlab>/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 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. AddModule mod_php4.c ABB Process Industries en 5

6 5. Tested program versions Matlab Web Server 6.1 Matlab R12 Apache win32 PHP win32 Microsoft Internet Explorer References [1] Matlab Installation Guide [2] [3] ABB Process Industries en 6

7 REVISION Rev. ind. Page (P) Chapt. (C) Description Date Dept./Init. ABB Process Industries en 7