MATLAB Web Server

General Post-Installation Procedures

After installing MATLAB and the MATLAB Web Server, you must perform a number of steps that regulate communication between MATLAB and your Web browser.

Note    Throughout this document the notation <matlab> represents the MATLAB root directory, the directory where MATLAB is installed on your system. For notational consistency in UNIX command syntax, the notation $MATLAB is used to represent the MATLAB root directory.

Note in particular:

1. To get the demonstration programs discussed in this chapter to work, you need to create a matweb.conf file in the
   <matlab>/toolbox/webserver/wsdemos directory. The Readme file shows the format for matweb.conf. Replace the notation <matlab> with the name of the root directory where you installed MATLAB. Use the matlabroot command to determine this directory. Also, replace matlabserver_host_name with the TCP/IP hostname for your machine.
2. The installation procedure creates the file matlabserver.conf in the <matlab>/webserver directory. The file contains the notation

• -m 1
  

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. On Windows NT edit matlabserver.conf directly with a text editor.

Note    To see any changes made to matlabserver.conf, you need to stop and restart the MATLAB Web Server. See the section Understanding matlabserver for more information on matlabserver.conf.

1. On Solaris/Linux use the webconf script to initialize the matlabserver.conf file. Then edit this file to change options further, particularly those that webconf cannot set on the command line.

3. Follow the directions provided by your Web server (httpd) to create the needed aliases:
1. The home or default directory
2. /cgi-bin
3. /icons

Point each of these aliases to <matlab>/toolbox/webserver/wsdemos to get the demonstration programs to work.

If your application creates graphic (jpeg) files, you need to provide a location where MATLAB can write these for httpd access, e.g, /icons. The mldir entry associated with each application in the matweb.conf file indicates the location to MATLAB.

If you do not have permission to set up or change these aliases, you must place copies of some files in locations where the httpd can find them.

• Copy matweb (matweb.exe on Windows NT), found in
  <matlab>/webserver/bin/arch, to the directory aliased by /cgi-bin or equivalent. The supported architectures are Windows NT (win32), Solaris (sol2), and Linux (glnx86).
• Copy matweb.conf in <matlab>/toolbox/webserver/wsdemos to the directory aliased by /cgi-bin or equivalent.
• Copy all demo HTML files in <matlab>/toolbox/webserver/wsdemos to the directory where the httpd keeps all HTML files (often referred to as the home or default alias).

Note that when aliases are different from those provided in the demo HTML files, you will have to make the corresponding changes in those HTML files. For example, if you use the Apache Web Server (http://www.apache.org), the aliases listed above are called:

1. DocumentRoot
2. ScriptAlias /cgi-bin/
3. Alias /icons/

You edit these in the conf/http.conf file in the main Apache directory. Note that any alias with a trailing '/', such as '/icons/', must have a trailing slash in its value, e.g.,
Alias /icons/ "/local/matlab/toolbox/webserver/wsdemos/".

Installation

Solaris/Linux Post-Installation Procedures