VERSION: 5.1
UNIX News for MATLAB
--------------------
Notation: $MATLAB is the MATLAB root directory path
--------
File: README.news51
----
0. Table of Contents
-----------------
1. Online documentation changes
1.1 Reorganized and broken into components
1.2 matlabdoc/doc base page now has WEB links to Globetrotter
Software, Inc.
1.3 Adobe Acrobat Reader with Search now provided on the CD-ROM
and on FTP
2. sgi and sgi64 platform issues
2.1 Use -sgi option to 'matlab' script to switch to a sgi
architecture on a sgi64
2.2 R4400 CPU products that return IRIX64 from `uname -s` now
have architecture set to sgi NOT sgi64
Appendix: UNIX Setup
--------
1. Online documentation changes
----------------------------
1.1 Reorganized and broken into components
--------------------------------------
The MATLAB online documentation has been broken into components.
There are the Help Desk, HTML documents, and PDF documents.
The HTML and PDF documents available with this release by
product are as follows.
Product HTML PDF
------- ---- ---
MATLAB x x
Simulink x x
Control Toolbox x x
Optimization Toolbox x
Signal Toolbox x x
Mapping Toolbox x
Real-Time Workshop x
Symbolic Toolbox x x
Image Processing Toolbox x
NCD Toolbox x
Statistics Toolbox x
Fuzzy Logic Toolbox x
DSP Blockset x x
Fixed-Point Blockset x
Wavelet Toolbox x
Communication Toolbox x
Stateflow x x
NOTE: The Help Desk is a default selected item for all CD-ROM
installations. It is required if any HTML or PDF documents
are installed. Deselect it only if you are installing
additional product after an initial installation that
includes MATLAB. For the FTP installation, the Help Desk
is part of the file matlab.common.
For the CD-ROM installation if you are licensed for a product
all documentation is selected. Therefore you must deselect
any help item that you do not want installed.
For the FTP installation if you download the product you get all
the online documentation associated with that product. Those
files are not broken out separately.
1.2 matlabdoc/doc base page now has WEB links to Globetrotter
---------------------------------------------------------
Software, Inc.
--------------
There are now two WEB links to Globetrotter Software, Inc. on the
matlabdoc/doc base page. The links are to their:
1. Home page
2. FLEXlm End User Manual
1.3 Adobe Acrobat Reader with Search now provided on the CD-ROM and
---------------------------------------------------------------
on FTP
------
Acrobat Reader 3.0 with Search is provided on the CD-ROM and
FTP for the following platforms:
sun4 sol2 hp700 ibm_rs sgi
The files were taken without change from the CD-ROM provided
by Adobe. You will need to install them using Adobe's
installation procedure.
The installation steps are summarized below. For complete
information see the appropriate document.
---------------------------------------------------------------
CD-ROM: (See Installation Guide for UNIX, Version 5.1)
1. Mount CD-ROM (assumed mounted on /cdrom).
2. Move to the acrobat directory.
cd /cdrom/acrobat (sun4,sol2.ibm_rs,sgi)
cd /cdrom/ACROBAT (hp700)
3. Run the install script and answer the install questions.
./install* (sun4,sol2,ibm_rs,sgi)
./INSTALL* (hp700)
---------------------------------------------------------------
NOTE: The Guide is available before installation in PostScript
form at the top level of the CD-ROM as files:
sun4,sol2,ibm_rs,sgi hp700 Paper Size
guide.ps GUIDE.PS;1 US
guide_a4.ps GUIDE_A4.PS;1 A4
---------------------------------------------------------------
---------------------------------------------------------------
FTP: (See FTP README file, README.unix)
1. Move to a working directory of your choice.
2. Download files.
FTP server working directory
unix/acrobat/acrobat.common acrobat.common
unix/acrobat/acrobat.$ARCH acrobat.$ARCH
(ARCH taken from: sun4 sol2 hp700 ibm_rs sgi)
3. Untar files.
tar -xvf acrobat.common
tar -xvf acrobat.$ARCH (for each ARCH downloaded)
Creates local directory:
acrobat
4. Run the install script in the acrobat directory and answer
the install questions.
cd acrobat
./install
5. Cleanup downloaded files and acrobat directory.
---------------------------------------------------------------
2. sgi and sgi64 platform issues
-----------------------------
2.1 Use -sgi option to 'matlab' script to switch to a sgi
-----------------------------------------------------
architecture on a sgi64
-----------------------
The matlab script now takes additional options of the
form:
-arch | -ext | -arch/ext
where
-arch
Run MATLAB assuming this architecture rather than
the actual machine architecture.
-ext
Execute the version of MATLAB with extension ext
if it exists for the actual machine architecture.
-arch/ext
Execute the version of MATLAB with extension ext
assuming this architecture rather than the actual
machine architecture.
The only current use of -arch is -sgi on sgi64. This will
allow the sgi version of MATLAB to run transparently on
the sgi64.
2.2 R4400 CPU products that return IRIX64 from `uname -s` now
---------------------------------------------------------
have architecture set to sgi NOT sgi64
--------------------------------------
Certain SGI machines with a CPU of 4400 are running IRIX64.
However, these are not MIPS 4 machines. Hence they must run
the sgi distribution. Now the architecture is figured out
automatically to be sgi.
========================================================================
Appendix: UNIX Setup
========================================================================
0. Table of Contents
-----------------
1. Product changes since MATLAB 5.0
1.1 New products
1.2 Updated products
1.3 Unchanged products
1.4 Products with unsupported architectures
2. Changes to operating system build list since MATLAB 5.0
3. Install MATLAB 5.1 over MATLAB 5.0
4. License manager changes
4.1 lmstart and lmdebug scripts now check for comments
4.2 lmhostid script returns `hostname` as the default for a Linux
machine without an ethernet card
4.3 Running license daemons on operating systems older than built
with MATLAB
5. Comments about operating system and tool requirements
5.1 sol2 (SUN Solaris 2)
5.1.1 MATLAB 5.1 on SunOS 5.4 will come up
5.2 sgi (SGI IRIX) and sgi64 (SGI IRIX64)
5.2.1 Platform support by Hardware/OS
5.2.2 Install both sgi and sgi64 products if you want to use
the Symbolic Toolbox on sgi64
5.2.3 MATLAB 5.1 on IRIX 5.x (at least 5.3) will come up
5.3 Help Desk
5.3.1 If Netscape Version 3 is being used, do not use
Netscape 3.0, use at least Netscape 3.01
6. CD-ROM installation
6.1 FLEXlm now appears as two items, FLEXlm and FLEXlm
scripts
6.2 Stateflow and Stateflow Demo install the same thing
6.3 Printing the license agreement in the GUI install
7. Help
1. Product changes since MATLAB 5.0
--------------------------------
1.1 New products
------------
Name Version
MATLAB Tour 1.0
Mapping Toolbox 1.0
Real-Time Workshop 2.1
DSP Blockset 2.0
Fixed-Point Blockset 1.1
NAG Foundation Toolbox 1.0.1
Stateflow 1.0
Stateflow Coder 1.0
Note: The MATLAB Tour is considered part of MATLAB and
is not separatedly licensed. It can be deselected
in a CD-ROM installation. It is part of the file,
matlab.common, in a FTP installation.
1.2 Updated products
----------------
Name Version
MATLAB 5.1
Simulink 2.1
Control Toolbox 4.0.1
System Identification Toolbox 4.0.3
Robust Control Toolbox 2.0.4
Optimization Toolbox 1.5.1
Spline Toolbox 1.1.4
Signal Toolbox 4.0.1
Mu Synthesis Toolbox 3.0.2
Neural Network Toolbox 2.0.4
Symbolic Toolbox 2.0
Extended Symbolic Toolbox 2.0
Image Processing Toolbox 2.0
NCD Toolbox 1.1.1
Statistics Toolbox 2.1.0
Frequency Domain ID Toolbox 2.0.2
MPC Toolbox 1.0.2
Fuzzy Logic Toolbox 1.0.3
QFT Toolbox 1.0.2
LMI Control Toolbox 1.0.3
Financial Toolbox 1.0.3
PDE Toolbox 1.0.2
Communication Toolbox 1.2
1.3 Unchanged products
------------------
Name Version
Hi Spec Toolbox 2.0.1
Applix Link 1.0.2
Wavelet_Toolbox 1.0.2
1.4 Products with unsupported architectures
---------------------------------------
Name Unsupported architectures
Symbolic Toolbox sgi64*
Extended Symbolic Toolbox sgi64*
NAG Foundation Toolbox hp700 alpha ibm_rs
sgi sgi64 lnx86
Applix Link sgi64 lnx86
*Use sgi version on sgi64. See section 6.3
for details.
cd acrobat
./install
2. Changes to operating system build list since MATLAB 5.0
-------------------------------------------------------
There is one change in the table below from MATLAB 5.0. The
IBM RS/6000 was built using AIX 4.2 for MATLAB 5.1.
Platform Build OS version
-------- ----------------
Sun Sparc (sun4) SunOS 4.1.4
Sun Sparc (sol2) Solaris 2.5
HP 9000 PA-RISC (hp700) HP-UX 10.01
DEC Alpha (alpha) Digital UNIX 4.0A
IBM RS/6000 (ibm_rs) AIX 4.2
Silicon Graphics (sgi) IRIX 6.2
Silicon Graphics (sgi64) IRIX 6.2
Linux (lnx86) Linux 2.0.18
A check is done of the OS version at the start of scripts like
'install', 'install_matlab', 'matlab', and 'mex'. The checking
has been revised for MATLAB 5.1. You will still get a mesage
if you are running an older version than what MATLAB 5 was
built with. However, if it is less than a minimum version an
'unsupported' message will be printed, but without a prompt
to quit. MATLAB may or may not come up successfully in that
case.
3. Install MATLAB 5.1 over MATLAB 5.0
----------------------------------
If you already have MATLAB 5.0, it is recommended that you install
MATLAB 5.1 over MATLAB 5.0. Obsolete files will be cleaned out.
The updating process uses file lists in the $MATLAB/update/pd
directory saved from installing MATLAB 5.0. If those have been
removed or damaged then the removal of obsolete files will be
incomplete. Because of the reorganization of the Online Help
there are many obsolete files that need to be removed.
NEVER install MATLAB 5.1 over any MATLAB 4.x or earlier MATLAB
version. DO NOT install MATLAB 5.1 over any MATLAB 5 alpha or
beta release, ONLY over the official MATLAB 5.0 release.
Scripts that are configurable by the user such as
$MATLAB/bin/.matlab5rc.sh will be updated in the following way.
1. If the 5.1 RCS revision number of the script has changed
since 5.0 then the new script will replace the old one with
the differences appended to the bottom as comments. The
user must check those differences and change the top of
the file accordingly.
2. If the script has not changed RCS revision number nothing
is done.
This applies to selected files in $MATLAB/bin, $MATLAB/etc, and
$MATLAB/toolbox/local.
4. License manager changes
-----------------------
4.1 lmstart and lmdebug scripts now check for comments
--------------------------------------------------
A comment is defined as a line that does not start with a
FLEXlm keyword like SERVER, DAEMON, FEATURE, or INCREMENT or
the '#' character. All other lines will be printed. Each
line is usually a continuation of a previous FLEXlm line
that got split by a mailer or other program.
lmstart and lmdebug scripts now check for comments.
4.2 lmhostid script returns `hostname` as the default for a Linux
-------------------------------------------------------------
machine without an ethernet card
--------------------------------
The lmhostid script when executed on a Linux PC without
an ethernet card now returns HOSTNAME=node as the value for
its hostid. node is the value returned by the local command,
hostname, if it exists. Otherwise, node is set to
'localhost'.
4.3 Running license daemons on operating systems older than
-------------------------------------------------------
built with MATLAB
-----------------
The FLEXlm vendor daemon on each platform is built at or
close to the operating system release number used to
build MATLAB. In many cases they operate correctly
on older releases. We have taken numbers supplied by
Globetrotter under which they built their libraries and
added our restrictions to produce a table that should
give a good idea of how far back you can run our
daemon with a high degree of confidence. Please be
advised we will not guarantee that things will always
work.
arch MathWorks minimum absolute minimum
1. sun4 4.1.2
2. sol2 5.3 5.1 <= OS_version < 5.3**
3. hp700 10.0 < 10*
4. alpha 4.0 < 4**
5. ibm_rs 4.0 3.1 <= OS_version < 4.0**
6. sgi 5.2
7. sgi64 6.1
8. lnx86 1.2.13
* Needs to be compiled and linked under that OS.
The MathWorks will not supply such as version.
** Not available to test.
5. Comments about operating system and tool requirements
-----------------------------------------------------
5.1 sol2 (SUN Solaris 2)
--------------------
5.1.1 MATLAB 5.1 on SunOS 5.4 will come up
------------------------------------
An additional library is provided automatically with
the sol2 MATLAB distribution so that MATLAB 5.1 will
come up successfully on SunOS 5.4.
5.2 sgi (SGI IRIX) and sgi64 (SGI IRIX64)
-------------------------------------
5.2.1 Platform support by Hardware/OS
-------------------------------
Legend:
------
-32 - 32 bit addressing
-64 - 64 bit addressing
MIPS2 - MIPS 2 instruction set
MIPS4 - MIPS 4 instruction set
platform MATLAB 5.1
-------- ----------
MATLAB binary CD-ROM installer binaries
sgi -32 MIPS2 -32 MIPS2
sgi64 -64 MIPS4 -32 MIPS2
MATLAB Support by Hardware/OS:
-----------------------------
1. Indigo, Indigo2, Indy, Crimson
IRIX: sgi only
2. Indy 5000
IRIX: sgi only
3. Challenge, Onyx, Onyx Infinite Reality (R4400)
IRIX: sgi only
IRIX64: sgi only
4. POWER Indigo2/POWER Challenge/POWER Onyx R8K and
all R10K-based systems
IRIX64: sgi64 only
5.2.2 Install both sgi and sgi64 products if you want to
--------------------------------------------------
use the Symbolic Toolbox on sgi64
---------------------------------
There is no native version of the Symbolic Toolbox on
the sgi64. However, the sgi version runs fine on the
sgi64. It is strongly recommended that if you are
licensed for the Symbolic Toolbox and plan to run it
on an sgi64 platform that you install BOTH the sgi and
sgi64 distributions for ALL licensed products not just
MATLAB and the Symbolic Toolbox. Otherwise you will
not be able to use any other licensed product that
has MEX-files at the same time as the Symbolic Toolbox.
When you want to run the Symbolic Toolbox on an sgi64
platform, start up matlab as follows:
matlab -sgi
5.2.3 MATLAB 5.1 on IRIX 5.x (at least 5.3) will come up
--------------------------------------------------
An additional library is provided automatically with
the sgi MATLAB distribution so that MATLAB 5.1 will
come up successfully under IRIX 5.3. However, MATLAB
5.1 is NOT supported under this release of IRIX.
5.3 Help Desk
---------
5.3.1 If Netscape Version 3 is being used, do not use
-----------------------------------------------
Netscape 3.0, use at least Netscape 3.01
----------------------------------------
Use Netscape 3.01 Gold at a minimum if you
upgraded to Netscape Version 3. There were some
ill behaving features in Netscape Version 3.0 which
are not in the later version.
6. CD-ROM installation
-------------------
6.1 FLEXlm now appears as two items, FLEXlm and FLEXlm scripts
----------------------------------------------------------
They are always selected. You should deselect both as a
pair only if you only want to install additional products
after a successful first installation which includes
MATLAB.
6.2 Stateflow and Stateflow Demo install the same thing
---------------------------------------------------
If you are licensed for Simulink a copy of Stateflow called
Stateflow Demo is also selected. Stateflow Demo has the same
files as the regular Stateflow product. If you are also
licensed for Stateflow you will in affect be installing
multiple copies of the same product. You do not need to
deselect any items. Except for additional processing no
extra product files are created.
6.3 Printing the license agreement in the GUI install
-------------------------------------------------
When you select the print button to print the MATLAB
license agreement the shell command that is executed
looks like:
echo text | lpr &
For this to work on your system the lpr print spooler
must be supported and installed. If lpr is not
available then the file to print on the CD-ROM is
/cdrom/matlab.lic (all except hp700)
or
/cdrom/MATLAB.LIC;1 (hp700)
where the CD-ROM is assumed to have been mounted on
/cdrom.
This file is also available after installation as:
$MATLAB/matlab.lic
7. Help
----
If you have questions or want to report problems please contact:
The MathWorks, Inc. Technical Support:
Email: support@mathworks.com
Phone: 508-647-7000
FAX: 508-647-7201
FLEXlm is a Trademark of Globetrotter Software
MATLAB is a Registered Trademark of The MathWorks, Inc.
PostScript is a Registered Trademark of Adobe Systems, Inc.
UNIX is a Registered Trademark of the Open Group Company
------------------------------------------------------------------------
Copyright (c) 1997-1998 by The MathWorks, Inc.
$Revision: 1.3 $ $Date: 1998/09/27 20:56:46 $
------------------------------------------------------------------------