MATLAB Installation Guide for UNIX
Contents
1. SPARC based workstation e SunOS 4 1 4 OpenWindows version 3 0 or X Windows X11R5 Sun SPARC Solaris 2 SPARC based workstation Solaris 2 5 or higher SunOS 5 x X Windows X11R5 HP 9000 HP 9000 PA RISC workstation HP UX 10 01 or higher e X Windows X11R5 DEC Alpha DEC Alpha workstation Digital UNIX 4 0 or higher DECwindows or X Windows X11R5 1 Installing MATLAB on UN IX W orkstations E 1 4 IBM RS 6000 BM RS 6000 workstation e AIX 4 1 e X Windows X11R5 Silicon Graphics 561 SGI R4000 MIPS based workstation e RIX 6 2 or above e X Windows X11R5 Silicon Graphics 56164 e SGI R8000 R 10000 MI PS based workstation e RIX 6 2 or above e X Windows X11R5 Linux 80486 or Pentium PC Linux 2 0 18 kernel Red Hat 4 0 distribution e X Windows X11R6 M ATLAB Installation Procedure MATLAB Installation Procedure The MATLAB software is ordinarily installed on a single file system This can be an individual user s computer in the case of a stand alone workstation or a central file server for networked installations The instructions that follow describe how to install MATLAB on a single system in either a stand alone workstation or file server environment Obtaining License Passcodes Before you begin installing MATLAB you must havea valid set of license pass codes from The MathWorks License passcodes include feature and archive pas2. 1 Installing MATLAB on UN IX W orkstations is configured for Netscape Y ou may modify this file if you want to specify an alternate Web browser additional initial browser options or a different ini tial path to the viewable documentation 17 TheM file mati abrc min MATLAB tool box mat isinvoked auto matically each time a user starts MATLAB Y ou can include welcome mes sages default definitions or any MATLAB expressions that you want to run for all users 18 Try starting MATLAB by executing mat ab or MATLAB bi n matlab depending on whether you put symbolic links into a directory on your path during installation If MATLAB does not execute correctly after installation refer to Trouble shooting below To learn more about the MATLAB license manager read License Manager Administration in Chapter 2 Installing MATLAB via FTP Authorized users with access to the Internet may obtain distributions of MATLAB and toolboxes by downloading the software via FTP This process avoids the delay inherent in waiting for The MathWorks to ship products on CD ROM You will need a MathWorks supplied password to log in to The MathWorks FTP server and obtain your software If you have not yet received your password contact The MathWorks e Via email at servi ce mat hworks com Via telephone at 508 647 7000 ask for Customer Service Via fax at 508 647 7001 When you reach The MathWorks FTP server f t p m
3. you cannot start the license manager if you are logged in as superuser If you want the license manager to start when rebooting the machine you must supply a valid user name when configuring the boot script 2 15 2 license Management ce get Troubleshooting If you encounter difficulties with the operation of the license manager follow these general steps On the license manager server usually the file server 1 Determine whether the license daemons are operating cd MATLAB etc mstat a If either the license server or vendor daemon is not running restart the dae mons by running mstart in thesame MATLAB etc directory If the license server and the vendor daemons still don t start check the end of the log file usually 1 1 095 for errors If the error message is con fusing refer to the section License Manager Error Messages on page 2 18 A suggested action accompanies each message If the problem is caused by mistakes in your i cense dat file correct thefile and restart the daemons by running mstart If the problem appears to be caused by network software contact your system administrator or your system vendor to resolve the problem Instead of running mstat you can usethe UNIX ps command to check for running processes On computers running Berkeley UNIX enter ps agx grep Im On computers running System V UNIX enter ps ef grep Im Check the output to d
4. 1 Installing MATLAB on UN IX W orkstations P This table lists commonly used commands and instructions Y our site may require additional options that are not listed here Contact your system admin istrator for information about site specific options 4 Verify that the CD ROM device file has the correct read and execute permis sions using the UNIX command Is I device wheredevi ce is the device name for your CD ROM drive To change permis sions log in as superuser and invoke the UNIX command chmod 555 device 5 Checkthefile MATLAB install matlab out for error messages 6 Todisplay additional diagnostic messages rerun the installation procedure using one of thei nstal commands install debug gt debug out Sun DEC SGI and Linux platforms INSTALL debug gt debug out HP platform 7 Rerun the installation procedure using one of the terminal options install t Sun DEC SGI and Linux platforms INSTALL t HP platform Installation Error Messages Error Can t open display After starting OpenWindows or Motif enter at the UNIX prompt xhost x Then run one of the installation procedures install Sun DEC SGI and Linux platforms I NSTALL HP platform 1 24 License Management 2 2 2 2 2 3 2 7 2 8 2 9 License Manager Administration Understanding License Types Understanding the license dat File License Administration Tools Determining Your Hostid
5. 19 Troubleshooting 1 20 2 License Manager Administration 2 2 Understanding License Types 2 2 Understanding the licensedat File 2 3 License Administration Tools 2 7 Determining Your Hostid 2 8 Running MATLAB on a Heterogeneous Network 2 9 Running MATLAB with Other FLEXIm Applications 2 10 Creating a Local Options 2 10 Configuring Redundant License Servers 2 12 Contents Troubleshooting 2 16 Diagnostic Report 2 17 License Manager Error Messages 2 18 Other License Manager Problems 2 23 MATLAB Directory Structure 3 MATLAB Directories and Files 3 2 MATLAB bin 2 6c tenes 3 3 eRe ew hd Ae ha Fes MA Ra EO 3 3 S MATLAB tOOIDOX 3 4 MATLAB extern 2 0 rs 3 4 Installing MATLAB on UNIX Workstations 12 1 2 1 2 1 3 1 5 1 5 1 6 Introduction Distribution Licensing System Requirements MATLAB Installation Procedure Obtaining License Passcodes CD ROM Installation Procedure 1 16 Installing MATLAB via FTP 1 19 Installing Additional Toolboxes 1 20 Troubleshooti
6. 3 Start MATLAB and if problems continue refer again tothe section License Manager Error Messages Diagnostic Report If these troubleshooting steps do not resolve the problem you are experiencing you should execute the script mdebug in the MATLAB etc directory and send its diagnostic results to The MathWorks Technical Support department The mdebug script will e mail its results to the Technical Support group automat ically if you are connected to the Internet If you are not you should fax the 2 17 2 license Management ce get O results to The MathWorks at the number listed below F or fax reports it is also helpful to include The exact error message s received e A copy of your l i cense dat file Y ou should also feel free to contact The Math Works Technical Support depart ment by phone or e mail Toreach The MathWorks Technical Support E mail support Qmathworks com Phone 508 647 7000 Fax 508 647 7201 License Manager Error Messages Some common license manager error messages are listed below The error mes sages are listed in alphabetical order and appear in bold followed by suggested troubleshooting steps Cannot connect to license server This error is displayed when starting MATLAB e Determine whether the license manager daemons are running thelicense server by running MATLAB etc mst at on the license server If the license daemons are not running execute MATLAB mstart l
7. I NSTALL amp HP platform Theinstall script displays a welcome screen MATLAB Installation MMATLAB instalation Welcome to the MATLAB 5 0 CD ROM installation c Copyright 1984 1996 by The MathWorks Inc 508 647 7000 minimum installation occupies about 40 MB of disk space and takes about 30 minutes to complete Select OK to proceed with the installation M ATLAB Installation Procedure 8 TheMATLAB Root Directory screen is displayed Select OK if the pathname for the MATLAB root directory is correct MATLAB Root Directory MATLAB root directory location fusrfocal imatiab pan DE te an in change E hare 0T HERE IECTA BALAN 11 pazasode Fila F r usa with aye demit LE Lot Lon Too Lors Baburt Taalbax Too Lor Lira Taalbac Signal Talba f you received your passcodes by e mail and copied the passcodes to the license dat filein step 3 check the license file to make sure the FEATURE 1 9 1 Installing MATLAB on UN IX W orkstations E lines match the passcodes provided by e mail If the passcodes and FEATURE lines match select the OK button to continue If the FEATURE lines donot match the passcodes provided in e mail or if you recei ved your passcodes by fax edit the license file directly on this screen until theFEATURE lines match the information provided on the passcode printout fa
8. If you try to reserve more than the authorized number of keys in the options file a warning message appears thel i cense l0g file A local options file might look something like the following RESERVE 1 MATLAB USER patricia RESERVE 3 MATLAB HOST pegasus RESERVE 1 CONTROL Toolbox GROUP devels RESERVE 3 CONTROL Toolbox HOST GROUP hosts INCLUDE SIGNAL Toolbox HOST orion INCLUDE SIGNAL Toolbox USER tom EXCLUDE SI MULI NK GROUP devels EXCLUDE SI MULI NK HOST GROUP hosts GROUP devels andrea tom fred HOST GROUP hosts cygnus sirrus Thelinesthat begin with RESERVE contain the number of product keys set aside for a specific user user group host or host group This does not limit the number of keys it simply ensures that a key will be available when you want it unless the specified number of reserved keys has already been reached Thelines starting with NCLUDE contain the products to be restricted to a par ticular user user group host or host group only that user user group host or host group is allowed to use this product You can have multiple NCLUDE linesfor thesamefeature including different users user groups hosts or host groups The lines starting with EXCLUDE contain the features to be restricted from a particular user user group host or host group that user user group host or host group is not allowed to use that product Y ou can have multiple XCLUDE 2 11 2 license Management eemi lines fo
9. MATLAB on UN IX W orkstations the MATLAB root directory at the top level For example the file matlab sun4 which is located at sun4 mat ab sun4 on the FTP server should appear after downloading it as mat ab sun4 at the top level of the MATLAB root directory Do not create a subdirectory calledsun4 in the MATLAB root directory and place the file there Do not use the FTP server compress feature to download these files unless there are instructions tothe contrary Each tar file is composed of files that are already compressed 7 Logout from the FTP server ftp bye 8 Extract boot ftp if you have not done so earlier Leave all the other files as is in the MATLAB root directory Do not untar them unless you need to delete the downloaded files before installation to save space The installation script will untar them for you and save them in theft p subdirectory below the MATLAB root directory 9 Execute the MATLAB installation script linstall matlab Be prepared to provide your License Number Site I D 10 Start the license manager cd etc Imstart Y ou must be on the host specified by theSERVER linein your license file 1 18 Installing Additional Toolboxes Installing Additional Toolboxes After initial installation you can purchase optional toolboxes that extend MATLAB and provide additional application specific capabilities To install these additional toolboxes 1 Stop the license manager wit
10. Running MATLAB on a Heterogeneous Network 2 10 Running MATLAB with Other FLEXIm Applications 2 10 Creating a Local Options File 2 12 Configuring Redundant License Servers 2 16 Troubleshooting 2 17 Diagnostic Report 2 18 License Manager Error Messages 2 23 Other License Manager Problems 2 license M anagement License Manager Administration To manage the per computer or per user licensing MATLAB uses a license manager called F LE XIm a product of GLOBE trotter Software nc Additional information is available online at ht t p www gl obetrotter com FLEXIm consists of a license manager daemon and a vendor daemon that run on a server node Theserver nodeis usually the file server on which MATLAB is installed Thelicense manager and vendor daemons run in the background on the server node They responsible for checking in and out license keys as users invoke and quit MATLAB Throughout this section references to the MATLAB directory refer to the direc tory in which the contents of theMATLAB distribution are installed Understanding License Types Three types of licenses are available Node locked Floating e Demo Node locked License A node locked license requires that MATLAB run on a specific CPU Thereare two types of node locked licenses Limited user node locked licenses which allow up to a predetermined number of users to use MATLAB or toolboxes concurrently on a designated MATL
11. TheFEATURE lines for both limited and unlimited user node locked licenses specify the hostid of the node to which the license is restricted A FEATURE line for a node locked license has the form FEATURE feature MLM5 expirdate users passcode HOSTI De hosti d 2 license Management rr o For an unlimited user license theusers field is 0 For example the following twoF EATURE lines allow an unlimited number of MATLAB users on host 7260d0g1 and a single Control Toolbox user on the same host FEATURE MATLAB MLM 5 01 jan 1997 0 0123456789ABCDEF1234 HOSTI D 7260d091 FEATURE Control Toolbox MLM 5 01 jan 1997 1 0123456789ABCDEF1234 HOSTI D 7260d091 When requesting alicense dat file for a node locked license from The Math Works you need to supply the hostid for the computer that will be running your copy of MATLAB See Determining Y our Hostid for complete informa tion on this subject Floating Licenses TheFEATURE line for a floating license has the form FEATURE lt feature gt MLM 5 lt expirdate gt lt users gt lt passcode gt Theusers field corresponds to the number of keys purchased for this feature Because it is a floating license the line does not specify a hostid This example of a floating license includes four keys to MATLAB FEATURE MATLAB MLM 5 01 j n 1997 4 0123456789ABCDEF1234 Using NCREMENT lines you can have more than oneentry for thesameF EATURE in your i cense dat file For e
12. and from 2 21 2 license Management rer o a client If the telnet connection succeeds then the fully qualified name is resolvable 3 Insert the fully qualified namefor the server on theSERVER lineofthelicense file 4 Invoke MATLAB etc I mstart to force the license manager to re read the license file No TCP license server exists This error is displayed when starting MATLAB e Ensurethat the TCP IP network software is running on your computer The license manager requires TCP IP even for stand alone computers Enter the UNIXtel net hostname command wherehostname is the name of the com puter running the license server If thet el net command does not connect to the specified host name computer there is a problem with your network con figuration The system administrator must resolve this problem before you can run MATLAB A TCP port number such as 1711 may be missing at the end of the SERVER linein your license file and your et c servi ces file may not be configured correctly Not a valid server host See Invalid hostid for this CPU Socket bind error e mown did not work correctly and not all license daemons were killed M an ually kill these daemons as outlined in step 1 of the Troubleshooting sec tion and then restart the daemons with MATLAB etc mstart TheTCP port number 1711 may bein use by some other program including another license manager The TCP port number 1711 is at the end of the SERVER
13. cdrom ro Export this information by executing exportfs av Execute share F nfs o ro d cd rom device cdrom Add the line to the exports file et c exports cdrom ro Export this information by executing exportfs av Add thelinetothe exports file etc exports cdrom ro Add the line to the exports file et c exports cdrom ro Export this information by executing exportfs av Add the line to the exports file et c exports cdrom ro Export this information by executing exportfs av Add the line to the exports file et c exports cdrom ro Export this information by executing kill s SIGHUP pid of rpc mountd pid of rpc nfsd The pi ds are taken from the output of the command ps agx 1 22 3 Mount the CD ROM on your computer using the appropriate mount instruc tions listed below cdrom host is the host name for the remote system con nected to the CD ROM drive Troubleshooting Platform Mount Instructions Sun SunOS 4 x mkdir cdrom mount r cdrom host cdrom cdrom Sun Solaris 2 x mkdir cdrom mount F nfs r cdrom host cdrom cdrom HP 9000 HP UX mkdir cdrom mount cdrom host cdrom cdrom r DEC Alpha Digital mkdir cdrom UNIX mount r t nfs cdrom host cdrom cdrom IBM RS 6000 AI X mkdir cdrom mount r cdrom host cdrom cdrom SGI IRIX mkdir cdrom mount r cdrom host cdrom cdrom Linux mkdir cdrom mount r cdrom host cdrom cdrom 1 23
14. each machine successively and type cd 1 matl ab etc mstart c usr licenses li cense dat Wait for the license manager daemons on the three machines to synchronize with each other This may take a few minutes If for some reason the license manager daemons do not connect take the daemons down on each machine and rerun the procedure Network traffic may affect the synchronization so it may require several attempts to establish a proper connection Again all three machines must connect for the license manager to begin serving keys Oncethe daemons are up and connected on all three machines only two machines are needed for a quorum theloss of any one machine will not cause any licenses to be revoked Starting the License Manager at Boot Time To have the license manager daemons start at boot time place a Bourne Shell code fragment intothe appropriate boot script by following directions in the table on page 1 14 License M anager Administration In addition on each server a link must exist between et c mboot and MATLAB et c 1 mboot This link is normally created during the MATLAB installation process However when running multiplelicense servers some or all of the systems often do not have MATLAB installed To create this link on a given server first login to the server as root then enter the following UNIX commands cd etc In s MATLAB etc 1 mboot Note To maintain program security
15. given to The MathWorks is correct If the hostid given is incorrect contact The MathWorks for new passcodes License dat is corrupted See Encryption code in license file is inconsistent Imgrd License manager Nota valid server host exiting This messageis displayed in the log file usually MATLAB etc license log5 Make sure that the hostname in the SERVER line of the license file usually MATLAB etc license dat iS correctly spelled and resolvable See also the error message MLM cannot find SERVER hostname in network database MATLAB cannot be started Invalid returned data from license server This error is dis played when starting MATLAB It occurs if you are running incompatible ver sions of the license manager daemon Y ou need to execute MATLAB etc I mstart to start the license manager and vendor daemons corresponding to the current version of MATLAB 2 20 Troubleshooting MATLAB cannot be started License server does not support this feature This error is dis played when starting MATLAB Check that the license manager was restarted or reread using MATLAB etc I mreread after making changes to your license file e Seeifthereis a typographical error in a FEATURE line of your license file MATLAB is not allowed on this host This error is displayed when starting MATLAB e Run MATLAB et cA mhosti d and makesurethat the hostid matches the pass codes Makesure your computer is running TCP
16. license information in a file other than MATLAB etc li cense dat you must indicate to MATLAB where the file is located You can define the file location to MATLAB by performing one of the following steps e Create MATLAB etc license dat as a symbolic link tothe central license file or e RedefinetheLM LICENSE FILE inthe MATLAB bi n matl ab5rc sh script Torun separate license servers use separate license files and install the servers on different hosts Creating a Local Options File You can instruct the FLEXIm license manager to Reserve one or more keys for a user group of users host or group of hosts Specify theusers groups of users hosts or groups of hosts that have permis Sion to access one or more products 2 10 License M anager Administration Touse these options you or your users can createal ocal opti ons fileand list its pathname as the fourth field on the DAEMON linein thefilel i cense dat Depending on the length of your paths this line can get quite long This example shows the line on two lines however you must type it on one line or use the continuation character at the end of the first line DAEMON MLM usr local matlab etc m matlab V usr local ab etc local opti ons Alocal options fileis not required If it does exist it can have one line or many lines reflecting your special needs The license manager allocates keys according to these options until all keys arein use
17. lineintheyour license file Check with your system administrator for another port number that you can use in your license file xxx is not currently licensed This error message is displayed when attempting to access a MATLAB toolbox wherexxx is the name of the tool box or feature name e g Signal Tool box There may bea typographical error in theF EATURE lineindicated by the error For example this error will occur ifSi gnal Tool box is entered as 2 22 Troubleshooting signal tool box Check the error message for typographical errors and case sensitivity in the name of the feature MakesuretheF EATURE line matches the passcodes as generated by The MathWorks Other License Manager Problems Changes to License File Unread by License Manager If you change the license file you must restart the license manager using MATLAB etc I mstart or run 1 Thel script calls the mdown script to shut down the license manager daemon Sometimes the mdown script does not succeed at its task A sure way to shut down the license manager daemons is to usethe UNIX ps command to check for running processes and then kill them manually using the UNIX ki I I command Seethe beginning of the Troubleshooting section for moreinforma tion MATLAB Can t Find LM LICENSE FILE MATLAB is installed on a file server e g in usr local matlab Theinstall script defines MATLAB as usr local matl
18. other user as an argument tothel mboot script The fragment for SPARCstations looks like this MATLAB FLEXI m Network License Manager Daemon if f Jetc lI mboot then letc I mboot u username amp amp echo MATLAB mgr d fi 1 13 1 Installing MATLAB on UN IX W orkstations A Platform Procedure Sun SunOS 4 x Get the code fragment from MATLAB etc rc m Place the code fragment at the end of etc rc local Fixusername argument tol mboot in this file Sun Solaris 2 x Get the code fragment from MATLAB etc rc I sol2 Place the code fragment at the beginning of et c ini t d I mgrd Fixusername argument tol mboot in this file If file link et c rc3 d 171 mgr d does not exist create it with cd etc rc3 d In s init d Il S17l mgrd HP 9000 HP UX Execute the commands cd MATLAB etc cp rc Im hp sbin init d flexlm Fixusername argument to mboot in this file Createthefile etc rc confi g d fl exl m containing the oneline FLEXI m 1 Then create the links cd sbin rc3 d In s sbin init d flexl m S900flexlm cd sbin rc2 d In s sbin init d flexl m Kl00flexlm DEC Alpha Digital Execute the commands UNIX cd MATLAB etc cp rc Im alpha sbin init d flexlm Fixusername argument tol mboot in this file Then execute the commands cd sbin rc3 d In s sbin init d flexl m S56flexlIm M ATLAB Installation Procedure Platform Procedure
19. which the passcodes were created This license file must be avail able on each server machine The MATLAB script defines the environment variableLM LICENSE FILE tobes MATLAB etc license dat thedefaultlicense file location This definition is contained MATLAB bi n matl ab5rc sh You can use this file to customize the environment variables associated with MATLAB If you want to change the location of the license file you can either edit MATLAB bi n matl ab5rc sh and change the location definition for LM LI CENSE FILE or you canreplace MATLAB etc li cense dat with a link of the same name pointing to the correct location of the i cense dat file If you edit the mati ab5rc sh file then you will need to specify the new location when calling the mst art script below 2 13 2 license Management eemi _ Starting License Manager Daemons To bring up the three license managers for this example interactively login to each machineasroot andrunthel mst art script For example ifthe MATLAB root directory is usr local matlab 1 Login topooh cd usr local matlab etc mstart 2 Login topi gl et cd usr local matl ab etc mstart 3 Login torabbit as cd usr local matl ab etc mstart If you change the definition of LM LICENSE FILE in matl ab5rc sh you need tousethe option when calling mst art For example if you changetheloca tion of the license fileto usr icenses license dat you must login to
20. 5 2 6 installation CD ROM 1 6 ftp 1 16 installation problems 1 20 CD ROM 1 20 installing toolboxes 1 19 L license demo 2 3 floating 1 2 2 3 2 6 multiuser 2 2 node locked 1 2 per machine 1 2 per user 1 2 single user 2 2 license administration tools 2 7 Index license manager administration 2 2 error messages 2 18 other problems 2 23 license number 1 6 1 12 1 18 license passcodes 1 5 icense dat file 1 5 2 3 2 5 2 11 icense 1094 2 8 m license file 2 8 mboot 2 7 mcksum 2 7 mdebug 2 7 mdebug script 2 17 mdi ag 2 7 mdlog 2 7 mdown 2 7 mhostid 2 7 mr emove 2 7 mreread 2 7 mstart 2 7 mstat 2 7 mver 2 7 local options file creating 2 10 M MATLAB directory structure 3 2 MATLAB bi n 3 3 MATLAB etc directory 3 3 MATLAB extern 3 4 MATLAB tool box directory 3 4 media contents 1 2 multiuser license 2 2 N node l ocked license 1 2 number license 1 6 0 obtaining your hostid 2 9 P passcodes 1 5 R RESERVE line2 11 S Screens installation data 1 12 installation options 1 11 license file 1 9 root directory 1 9 SERVER line2 4 2 10 single user license 2 2 2 5 site D 1 6 1 12 1 18 system requirements 1 3 T TMW Archive line2 4 tool boxes installing 1 19 troubleshooting diagnostic report 2 17 error messages 2 18 file permission problems 1 20 license manager 2 16 other license manager problems 2 23
21. AB server Because the license manager must keep track of the number of actual MATLAB users the license manager must run if you have this type of license Unlimited user node locked licenses which do not set any predetermined limit on the number of people to use MATLAB or toolboxes concurrently on a single host With no set number of users to account for the license manager does not have to run if you have this type of license However you must set up thelicense dat file correctly see below License M anager Administration Floating License A floating license specifies the maximum number of concurrent MATLAB users allowed These users are not restricted to any particular host Because the license manager must keep track of the number of actual MATLAB users the license manager must run if you have this type of license Demo License A demo license is a temporary license equivalent to a floating license for an unlimited number of users You do not have to the license manager along with this type of license but you do have to set thel i cense dat file prop erly Understanding the license dat File TheASCII files MATLAB etc license dat contains configuration information including the number of license keys and the hostids of the licensed CPUs 2 license Management The file includes Two comment lines beginning with the character indicating license ver sion License Number and hostid informati
22. IP which is the network software required by the license manager See Invalid hostid for this CPU No features to serve MLM daemon found no features Please correct license file and re start daemons This may be due to the fact that you are using a different license file from the one you expect Check to make sure that usr tmp Im TMW dat is the license file you want to use This message is displayed in the log file usually MATLAB etc license log5 In mostinstances this error can be ignored since it shows up thelogfilein a CPU locked multiuser license The error message there are truly no features to serve means that the number of keys on each FEATURE lineis zero You should still be able to run MATLAB successfully MLM cannot find SERVER hostname in network database This error commonly occurs when the license server and the client running MATLAB different domains The local hostname listed in the license file cannot be resolved on the remote domain To allow access across separate domains do the following 1 All domains including the license server must be able to resolve the fully qualified name for the license server through the host table DNS or Yellow Pages Y ou may need to place an alias in the license server s local host table for the fully qualified name 2 Toverify that the server name can be resolved use telnet to remotely login tothe server computer using the fully qualified name from itself
23. MATLAB The Language of Technical Computing Computation Visualization TE Programming Installation Guidefor UNIX Workstations Version 5 How to Contact The MathWorks 508 647 7000 508 647 7001 The MathWorks Inc 24 Prime Park Way Natick MA 01760 1500 http www mathworks com ftp mathworks com soft sys matlab Support mathworks com Suggest mathworks com bugs mathworks com doc mat hworks com subscri begmathworks com service mathworks com info mathworks com Phone Fax Mail Web Anonymous FTP server Newsgroup Technical support Product enhancement suggesti ons Bugreports Documentation error reports Subscribing user registration Order status license renewals passcodes Sales pricing and general information Installation Guidefor UNIX Workstations December 1996 COPYRIGHT 1984 1996 by The MathWorks Inc All Rights Reserved The software described in this document is furnished under a license agreement The software may be used or copied only under theterms of the license agreement No part of this manual may be photocopied or repro duced in any form without prior written consent from The M ath Works I nc U S GOVERNMENT If Licensee is acquiring the software on behalf of any unit or agency of the U S Government the following shall apply a for units of the Department of Defense RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the Government is subj
24. RS 6000 AI X SGI IRIX Linux Get the code fragment from MATLAB etc rc I m ibm rs Place the code fragment at the end of et c rc nfs Fixusername argument tol mboot in this file Execute the commands cd MATLAB etc cp rc Imsgi etc init d Im Fixusername argument tol mboot in this file Then execute the commands cd 2 In s fetc init d Im 5451 Get the code fragment from 1 Place the code fragment at the of etc rc d local Fixusername argument tol mboot in this file 14 Before you can start MATLAB the license manager daemon must be run ning except for demo and CPU locked unlimited user licenses If the daemon is not running start it by rebooting your system or by executing mstart Thel mstart script isin the MATLAB etc directory Note Any time you make changes tothel i cense dat file you must run mr eread or restart the license daemons by running mstart Imstart brings down any currently running daemons and starts new ones 15 TheM filepri nt opt min the directory MATLAB tool box matlab local contains the options for the pri nt command that MATLAB uses to spool graphics hardcopy Y ou can edit this file to set an appropriate site wide default for device type and location 16 TheM filedocopt min the directory MATLAB t ool box 1 1 con tains options that control viewing of the MATLAB on line documentation It 1 15
25. TURE FEATURE MATLAB MLM 5 01 jan 1997 1 0123456789ABCDEF 1234 SI MULI NK MLM 5 01 jan 1997 0 0123456789ABCDEF1234 HOSTI D DEMO Control Toolbox MLM 5 01 jan 1997 1 0123456789ABCDEF1234 Identification Toolbox MLM 5 01 jan 1997 1 0123456789ABCDEF1234 When installing MATLAB make certain that theFEATURE lines in your license dat file exactly match the information provided you by The Math Works To avoid unnecessary warning messages from appearing in the log file upon startup delete all FEATURE lines associated with products you are not using If you upgrade your license or need to move the license server to a different workstation The M athWorks can give you new information by fax e mail or telephone If you changethel i cense dat file besuretorerun mreread or restart the daemons by running mstart Note In creating your i cense dat file avoid line breaks in FEATURE lines if at all possible If you must break a FEATURE line place a line continuation character at the end of the line before continuing to the next line e Oneor more NCREMENT lines which can be used in place of a feature line to incrementally add to a prior FEATURE or NCREMENT line in the file If you want to have additional copies of the same feature you must use multiple NCREMENT lines FEATURE MATLAB MLM 5 01 jan 1997 1 0123456789ABCDEF1234 NCREMENT MATLAB MLM 5 01 jan 1997 1 0123456789ABCDEF1234 HOSTI D 7260d091 Node Locked Licenses
26. ab in matl ab5rc sh If MATLAB is automounted on other workstations in directories other than usr local miti ab MATLAB fails at startup because it cannot find LM LICENSE FILE LM LICENSE FILE is determined by MATLAB Edit MATLAB bi n mat ab5rc sh and comment out the line that defines the variable MATLAB If this lineis not found in mat ab5rc sh is deter mined automatically when MATLAB is started License Key Unusable on Crashed Node When running MATLAB on a node that crashes the license key sometimes remains unusable i e it is never released back tothe license manager To releasethe key without restarting the license manager usethe MATLAB etc I mremove utility This script allows you to remove a single user s license for a specified feature by returning the license to the pool of available licenses Refer tothe script for the exact usage Shell Escape to Start Another FLEXIm Application Fails If the valueofLM LICENSE FILE is correct in the environment before you start MATLAB the following edit can be done to the MATLAB bi matlab5rc sh 2 23 2 license Management PER fileto make it available inside MATLAB Under the appropriate architecture edit theLM LI FILE lineso that it reads LM LICENSE FILE MATLAB etc license dat LM LICENSE FILE This edit simply concatenates the string LM LI CENSE FILE with evalua tion using double quotes to the end of the line Don t f
27. athworks you will find a document entitled README uni x This document contains the complete 1 16 M ATLAB Installation Procedure information you need toinstall MATLAB viaFTP Theinformation provided in this book will help you get started 1 Beforestarting the FTP process create a location on your local system where you will install MATLAB 5 For example if usr local matl ab5 isto bethe MATLAB 5 root directory then cd usr local mkdir matlab5 cd matlab5 2 Placea copy of the license file in the MATLAB 5 root directory and call it license dat See Chapter 2 for a complete discussion of the License Man ager and thel i cense dat file 3 Logonto The MathWorks FTP account with the password previously pro vided ftp ftp mathworks com Name login name Password password 4 Transfer a copy of the README uni x document which contains complete details of the installation process to your local computer ftp asci ftp get README uni x 5 SettheFTP server to binary mode ftp binary 6 Transfer theappropriate files fromtheF TP server to your system using FTP commands If you are not sure what to download download just the fileboot ftp ftp get boot ftp ftp gt bye Extract the file using the commandtar xvf boot ftp Then install matlab f which checks that you have a valid license file Unless specifically instructed otherwise all files should be downloaded to 1 17 1 Installing
28. ect to restric tions as set forth in subparagraph c 1 ii of the Rights in Technical Data and Computer Software Clause at DF ARS 252 227 7013 b for any other unit or agency NOTICE Notwithstanding any other lease or license agreement that may pertain to or accompany the delivery of the computer software and accompanying documentation the rights of the Government regarding its use reproduction and disclosure are as set forth in Clause 52 227 19 c 2 of the FAR Contractor manufacturer is The MathWorks Inc 24 Prime Park Way Natick MA 01760 1500 MATLAB SIMULINK and Handle Graphics are registered trademarks and Real Time Workshop is trade mark of The MathWorks Inc Other product or brand names are trademarks or registered trademarks of their respective holders Printing History December 1996 First printing for MATLAB 5 Contents Installing MATLAB on UNIX Workstations 1 Introduction cette teen nnn 1 2 Distribution 1 2 EIGENSING 1 2 System 1 3 MATLAB Installation Procedure 1 5 Obtaining License Passcodes 1 5 CD ROM Installation Procedure 1 6 Installing MATLAB via 1 16 Installing Additional Toolboxes 1
29. er must be chosen This is the machine to which clients connect first and which receives the majority of the network traffic The primary server is the first server listed in the license file If this machine fails the next server listed in the license file becomes primary 2 Theservers should be running supported versions of their operating sys tems 2 12 License M anager Administration Determine hostids Once you have chosen the servers you need to determine the hostid of each server You must submit all three servers hostids for the passcodes to be prop erly generated Use the information on page 2 8 to determine hostids Installing License Passcodes Once you have submitted the hostids for the servers you will receive a license passcode file In this example with servers pooh pi gl et andrabbi t the license dat file looks like the sample below MATLAB license passcode file for use with FLEXI m 5 0a LicenseNo 12345 Host D 7260d091 Host D 7275caal Hosti D 72701448 SERVER pooh 7260d091 1705 SERVER piglet 7275caal 1705 SERVER rabbit 72701448 1705 DAEMON MLM usr local matl ab etc l m matlab FEATURE Archi ve MLM 5 01 jan 1997 0 0123456789ABCDEF1234 VENDOR STRING 3 HOSTI D DEMO FEATURE MATLAB MLM 5 01 jan 1997 2 0123456789ABCDEF1234 FEATURE SI MULI NK MLM 5 01 jan 1997 1 0123456789ABCDEF1234 Note that thel icense dat file must have threeSERVER lines one for each hostid with
30. er thei nstall 1 Sun DEC IBM SGI and Linux platforms or NSTALL 1 HP platform com mand Usea native operating system command to determine your hostid License M anager Administration Hardware Hostid Description How to Obtain the Hostid Sample Hostid Platform Sun SPARC 32 bit hostid Enter thehosti d command 170a3472 HP 9000 32 bit hostid echo uname i 160 p dc 778DA4550 Ethernet address nscan use station address without 070020005532 leading 0x DEC Alpha Ethernet address usr sbin netstat i 080020005532 Look under address and remove all colons from entry associated with n0 SGI 32 bit hostid echo etc sysinfo s 160 p dc 90440225 IBM RS 6000 32 bit hostid Enter theuname m command 00249477 Remove the last two digits and use the lowest eight digits ignoring any high level zeros of the eight Linux Ethernet address sbin ifconfig eth0 00400516E 525 Use the string tothe right of HWaddr and remove all colons The MATLAB license manager uses different hostid formats for different hard ware platforms because some hardware platforms such as Sun have a unique hostid while others do not For this reason the Ethernet address is used on some platforms as the unique hostid An Ethernet address is 6 bytes long and each byte is specified as two hex digits Specify all 12 hex digits when using an Ethernet address as the hostid For example if the Ethernet address is 8 0 20 0 5 AC spec
31. etermine if both the license manager daemon m TMW5 1d andthevendor daemon MLM arerunning Only one version of each process should berunning Removeall duplicate daemons manually To 2 16 Troubleshooting kill processes you must be logged in as superuser then execute the com mand kill 9 pid_of_daemon Restart the daemons by running mst art Follow the previous instructions if the daemons fail to start Verify that all the features and keys for which you are licensed are recog nized by the license manager To do this look at the output of mstat a Make any changes necessary to the license file and restart the daemons by running mst art The output from the log file usually MATLAB etc license l0g5 should be checked for messages 2 Verify that your client workstation can connect to the license manager dae mons by executing the following commands on your client workstation not the server cd MATLAB etc mstat a If either the license server daemon or vendor daemon is not running on your local computer but is running correctly on the license server the problem is usually caused by network software The network softwareis either not run ning correctly or is not configured correctly Look for the error message in the section License Manager Error Messages A suggested action accompa nies each message I n addition you may need to contact your system admin istrator or system vendor to resolve the probl em
32. f thelicenseman ager does not start check the log file usually MATLAB etc license l095 for diagnostic messages e f the license manager is running on the license server and this message is displayed on your host ensurethat the TCP IP network softwareis running on the computer E ven for stand alone computers the license manager requires TCP IP Enter theUNIXtelnet hostname command where hostname is the name of the license server computer If telnet does not return a successful session on host name thereis a problem with your net work configuration The system administrator must resolve this problem before you can run MATLAB Invalid returned data from license server This error occurs when incompatible dae mons are running Most often this error is due to an installation update of MATLAB in the same directory as the previous version where the daemons 2 18 Troubleshooting were not shut down before the update was installed If the daemons not shut down then an update of MATLAB will not replace the daemon files To fix this problem shut down the currently running daemons and reinstall only the license manager files Encryption code in license file is inconsistent See the log file usually MATLAB etc license log5 It should indicate the specificF EATURE line for which it found bad codes in your license file usually MATLAB et c license dat Check the 20 digit passcode closely for typographical errors This i
33. ger scripts arch Directory with license manager binaries README license Online of the troubleshooting notes MATLAB toolbox matlab MATLAB Toolbox M files mat ab local Local environment M files other Any other toolboxes you may have installed MATLAB extern incl Indude files for C language programs with prototype dec larations Ilib Object libraries with compiled versions of the Application Program Interface routines beneath an architecture spe cific name for example sun4 src Source code for example programs that demonstrate the use of routines in the Application Program Interface Library 3 4 Symbols MATLAB bin directory 3 3 MATLAB etc directory 3 3 MATLAB etc directory 3 3 MATLAB extern directory 3 4 MATLAB tool box directory 3 4 eet MAGO SS C CD ROM installation 1 6 CD ROM problems 1 20 comment lines 2 4 creating a local options file 2 10 D DAEMON line 2 4 2 10 2 11 demo license 2 3 determining your hostid 2 8 diagnostic report 2 17 directory structure MATLAB 3 2 E error messages common license manager 2 18 evaluation software running off the CD ROM 1 19 EXCLUDE line2 11 F FEATURE line 2 4 2 6 2 7 2 10 file permission problems 1 20 FLEXIm 2 2 applications 2 10 floating license 1 2 2 3 2 6 ftp installation 1 16 G GROUP line2 12 H hardware 1 3 hostid determining 2 8 obtaining 1 6 2 9 INCLUDE 2 11 INCREMENT line2
34. h the mdown command See License Admin istration Tools on page 1 7 for information about this and other license manager commands 2 Edit yourlicense dat fileto add FEATURE line s for any new toolboxes 3 Perform the installation process 4 Restart the license manager with the mst art command 1 19 1 Installing MATLAB on UN IX W orkstations Troubleshooting File Permission Problems During installation certain files are checked for world or other access permis sions If any of the permissions are incorrect you should exit from the installa tion procedure set the user mask correctly extract the distribution and then reinstall MATLAB During installation the user mask is checked for a correct range of values If the user mask is outside of the correct range you are prompted for an alterna tive This provides correct permissions to any files created during the installa tion For theMATLAB system to execute correctly for the general user the sug gested file permissions are Scripts and directories chmod 755 Executable images chmod 755 All other files chmod 644 CD ROM Problems The CD ROM installation program depends upon the machine it runs on It expects that the CD ROM drive is connected or properly mounted tothe MATLAB server Y ou cannot transfer the contents of the CD ROM to the MATLAB server and run the installation program because the program con tains environment variables related
35. ify the hostid as 0800200005AC Running MATLAB on a Heterogeneous Network You can run MATLAB on a heterogeneous network with workstations of dif ferent architectures running off the same license server F or example if you have a network with two SPARCstations an AlphaStation and an HP 9000 and you are licensed for three floating keys and multiple platforms you can 2 license Management ce get select any of your computers as the license server for all four computers The three keys will float among all four computers To implement a heterogeneous licensing configuration select one of the machines to be the license server Create valid i cense dat file incorpo rating this machine s hostid On the other machines in the network create a link for thel i cense dat file pointing i cense dat file on the server machine Running MATLAB with Other FLEXIm Applications If you have another application that uses the FLEXIm license manager you can share a single license server or set up separate license servers for each product on different hosts To share a license server combine the DAEMON and FEATURE lines from both license files into a single license file with the appropriate SERVER line and install a license server on a single host If MATLAB and the other application are using different versions of the F LEXIm software run the newer version of the license server If you share a license server and you centralize the
36. n obtain the hostid by logging onto the server and executing the UNIX command host id For other UNIX plat forms log onto your server and follow the instructions in the section Deter mining Your Hostid on page 1 8 Besureto provide your server hostid not your client workstation hostid 3 Your email address if you have one Once you have obtained your i cense dat passcodes you can begin the instal lation procedure CD ROM Installation Procedure Toinstall MATLAB on your UNIX workstation from CD ROM 1 Login to your file server Superuser status is required toinstall the symboliclinks that add MATLAB to your users paths and to install the MATLAB man pages Superuser status is also required to edit the system boot script to start the MATLAB license manager automatically at system boot time If you do not have super user status you can still install MATLAB but MATLAB programs must be M ATLAB Installation Procedure invoked using absolute pathnames and the MATLAB license manager must be started manually each time the system is rebooted Choose a location for MATLAB on your file system Move tothe directory location using thecd command and create a new directory named mat ab For example if you select the location usr local use the commands cd usr local mkdir matlab cd matlab Subsequent instructions refer tothis directory as MATLAB If you received your license passcodes by e mail create a new file
37. named license dat in the MATLAB directory and copy the license passcodes from your e mail system into the i dat file The installation program automatically moves i cense dat fileto MATLAB etc a later step f you received your license passcodes on paper or by fax you may omit this step Create a directory to be the mount point for the CD ROM mkdir cdrom Place the MATLAB CD ROM label face up into the CD ROM caddy Make sure the arrow on the caddy is pointing towards the CD ROM drive Insert the caddy intothe drive Execute the command to mount the CD ROM on your system Use the table below to determine the correct command for your system Note that the actual device name you use may depend on the SCSI port to which your CD ROM drive is attached 1 Installing MATLAB on UN IX W orkstations A Platform Mount Command Sun SunOS 4 x mount t hsfs r dev sr0 cdrom Sun Solaris 2 x mount F hsfs o ro dev sr0 cdrom HP 9000 HP UX mount t cdfs r dev dsk cdrom cdrom DEC Alpha Digital UNIX mount t cdfs r o noversion dev rz3c cdrom IBM RS 6000 AI X mount v cdrfs r dev cd0 cdrom SGI IRIX mount t 1509660 o setx dev scsi scOdn10 cdrom Linux mount t 1509660 dev cdrom cdrom 7 Run the CD ROM install script Use either the upper case or lower case ver sion as appropriate for your platform Icdrom install amp Sun DEC SGI and Linux platforms or cdrom
38. ng 1 Installing MATLAB on UN IX W orkstations P Introduction This guide contains instructions for installing the MATLAB software and its license manager FLE XIm a product of GLOBEtrotter Software Inc These instructions assume that you have a basic working knowledge of UNI X If you arenot familiar with the UNI X environment please seek the assistance of your local system administrator Distribution MATLAB is distributed on CD ROM or over the Internet via ftp The CD ROM media contains e The MATLAB program Related utility files e Any program options you purchased such as tool boxes Demonstration software e The MATLAB Help Desk For a detailed list of the files see Chapter 3 MATLAB Directory Structure Licensing TheMathWorks licenses MATLAB on a per computer or a per user basis e f licensed per computer MATLAB operates only on a specified CPU or CPUs This license type is called node locked Node locked licenses allow either a fixed number or an unlimited number of users to access MATLAB concurrently e f licensed per user MATLAB can execute concurrently on any computer in a network for a specified number of users This license type is called a floating license System Requirements System Requirements Minimum system resources 40 MB disk space 16 MB memory 64 MB swap space Other system requirements depend on the particular platform on which you arerunning MATLAB Sun SPARC SunO S 4
39. on MATLAB license passcode file for use with FLEXI m 5 0a LicenseNo 12345 Hosti D 7275caal ASERVER linethat describes the license manager daemon SERVER madmax 7275caal 1711 TheSERVER line has the general format SERVER hostname lt hostid gt TCP PortNumber The1711 at theend of theSERVER linespecifies the TCP port number to use for communication with the daemons Do not changethis number unless you know it conflicts with other software Y ou can useany port number however torun the daemons from a nonroot account the port number must be greater than 1024 If your network is running NIS Network Information Services formerly Sun Yellow Pages and you prefer to consolidate TCP port number assignments you can remove the number from the end of theSERVER line and add it tothe file etc services on the NIS server by inserting license 1711 tcp Propagate the services map to the network by typing cd var yp make A DAEMON line that describes the vendor daemon DAEMON MLM usr local matlab etc m mat ab Archi ve linewith archive passcodes used only during the installation process FEATURE TMW Archi ve MLM 5 01 jan 1997 0 0123456789ABCDEF1234 VENDOR STRI NGz 7f f ff Ff fff HOSTI D DEMO A series of FEATURE lines that itemize the products you are licensed to use for example MATLAB SIMULINK and any toolboxes you have purchased 2 4 License M anager Administration FEATURE FEATURE FEA
40. orget the colon and the double quotes 2 24 MATLAB Directory Structure 32 MATLAB Directories and Files 33 3 MATLAB bin 33 MATLAB etc 34 MATLAB toolbox 34 MATLAB extern Directory Structure MATLAB Directories and Files Thes MATLAB directory refers to the directory where you installed the MATLAB software It contains these subdirectories and files lapp defaults bin etc toolbox extern help man linstal README instal matlabdoc install ps install _ matlab Files containing keyboard mapping and default window parameters for MATLAB and SIMULINK Scripts for executing the MATLAB system and com puter specific subdirectories for the binary images All files associated with the license manager including license dat and computer specific subdirectories Toolbox subdirectories Subdirectory containing subdirectories for source include files and libraries for the Application Program Interface MATLAB Help Desk UNIX man pages for the MATLAB system Install scripts and files Installation information in ASCII format Script to start online documentation PostScript copy of this Installation Guide The top level script that installs the MATLAB system MATLAB Directories and Files MATLAB bin matlab matlab5rc sh Script to invoke MATLAB Script used by MATLAB to customize behavior me x Script to create C C and FORTRAN MEX files mexopts sh Scrip
41. r the same feature excluding different users user groups hosts or host groups Any line starting with GROUP defines the users in that group name If a user group nameis used in aRESERVE I NCLUDE Or EXCLUDE line the group member ship must be defined in aGROUP line Any linestarting with HOST GROUP defines the hosts in that host group name If a host group nameis used in a RESERVE NCLUDE or EXCLUDE line the group membership must be defined a HOST GROUP line Configuring Redundant License Servers If a large number of licenses are governed by a single license server failure of the server becomes a major event To prevent problems it is occasionally desir ableto set up redundant servers sothat if one server goes down the license manager can still function In the redundant server configuration three machines are designated to be license servers All three machines must be running at thetimethe license manager is started H owever once the license manager is running only two machines need to be running at once this is called a quorum As longas a quorum exists the license manager can continue to run This configuration is allowable only for floating licenses Selecting Servers Thefirst step in configuring the license manager is choosing the servers The servers should be chosen with these two criteria in mind 1 Theservers should be able to handle the network traffic associated with license management A primary serv
42. s most likely the problem There should bezeros and not theletter O MakesureBs are not 8s and vice versa The date format in your license file may be incorrect e g 01 97 instead of 01 mar 1997 The date format should always match the passcodes that were sent by e mail or faxed to you Feature not yet available Feature is not enabled yet Logfile version of message Check for typographical errors in the 20 digit passcode of the FEATURE lines in your license file The date on your system may be incorrect To check the date usethe UNIX dat e command at the UNIX prompt 2 19 2 license Management ce get O Environment variable LM LICENSE FILE is not defined and the default license file M ATLAB etc license dat does not exist Check to make sure that MATLAB has been properly installed on your machine This error is displayed when starting MATLAB Check the directory where you are running MATLAB Make sure that you are running the script MATLAB bi n matlab Check that you arerunning the correct version of the operating system as specified in the System Requirements section Invalid hostid for this CPU Makesure the hostid on the fax or e mail matches the hostid on the SERVER linein your license file e Make sure the hostid on the SERVER lineis correct for the hostname that is also on theSERVER linein your license file e Execute the MATLAB etc 1 mhosti d command to make sure that the hostid
43. scodes for all the products in the MATLAB family for which you are licensed License passcodes are stored in filecalled i cense dat on your disk Passcodes for the cense dat file are usually supplied by fax or e mail The MathWorks prefers to send passcodes by e mail because that saves you from entering the passcodes by hand If you already have your i cense dat passcodes please proceed to the instal lation instructions If you do not contact The MathWorks immediately and request your passcodes e Via e mail atservi cegmat hworks Via telephone at 508 647 7000 ask for Customer Service Via fax at 508 647 7001 e Via World Wide Web http www mat hworks com Choose Express passcodes 1 Installing MATLAB on UN IX W orkstations Please have ready indude your e mail or fax the following three items 1 Your License Number a f you have not previously installed MATLAB at your site you can find your License Number Site ID the upper right hand corner of the packing slip b If you are updating an existing MATLAB installation and MATLAB is running typel i cense orver atthe MATLAB prompt c If MATLAB is not running due to a license manager issue cat the file MATLAB tool box matl 1 1 cense m MATLAB is a variable identifying the MATLAB root directory 2 Thehostid for the server on which you will execute the MATLAB license manager On Sun workstations you ca
44. t to customize mex behavior for and FORTRAN cxxopts sh Script to customize mex behavior for and F OR TRAN gccopts sh Script to customize mex behavior for GNU C and GNU FORTRAN MATLAB etc license dat ASCII file with license manager passcode information license dat skel im mdebug merror mboot mstart md own mstat mhostid mgr d mreread Template for generating license files Code segment to include in a system file to restart the daemons at boot time Platform specific versions have extensions for example c hp Script to generate installation diagnostics MATLAB license manager failure script Script to start license manager at boot time Script to start license manager Script to bring down license manager Script to display current status of license manager Script to display unique host identification number used by license manager Script to invoke license manager daemon Script to notify license daemons of changes in the license dat file 3 3 Directory Structure m matlab Script to invoke MATLAB spedific license manager daemon mver Script for reporting FLEXIm version mcksum Script for producing license file checksums mdi ag Script for diagnosing problems when you cannot check out a license mdi og Script for starting diagnostic log file mopts sh Script used by license manager to customize behavior util Special utilities required by license mana
45. the license manager Diagnose problems when a license cannot be checked out Start diagnostic log file Shut down all license daemons Display hostid of computer on which you are running Return license to license pool Reread license file Start license daemons Show status of all network licensing activities See the script for a complete set of options Display version number of license manager 2 license Management rer o 2 8 The file i cense 1 005 where the license daemon s output is redirected con tains a log of all license check outs check ins and denials The default direc tory for this file is MATLAB etc A new entry is recorded in the log each time a transaction occurs To save file space you can delete it occasionally Thefile matlab5rc sh in MATLAB bi n sets the environment variable LM LICENSE FILE tocontain the pathname of i cense dat which is normally MATLAB etc license dat If necessary you can change this environment variable to point to some other location Determining Your Hostid There are two ways to determine your server hostid if MATLAB is already installed Log onto the computer that you execute the license manager on and run the script mhostid in the MATLAB etc directory e Start MATLAB and enter thehost id command at the MATLAB prompt There are two ways to determine your server hostid if MATLAB is not installed e Logonto your server mount the CD ROM and ent
46. tothe CD ROM drive Remoteinstallation will not succeed if the CD ROM drive is mounted to a machine with an archi tecture different from that of the MATLAB server 1 20 Troubleshooting Use the following checklist if you encounter difficulties with the CD ROM installation 1 Determineif you arerunningthe correct system software as in the examples shown below Platform System Software Sun SPARC SunOS OpenWindows 3 0 with a patch for Motif Sun SPARC Solaris Solaris 2 5 RS 6000 AI X AIX 4 1 with Motif 1 2 libraries Verify that the device is mounted correctly by checking the mount command table in the CD ROM Installation section 2 If the CD ROM driveis located on a remote system follow these instruc tions You must be logged in as superuser to perform all steps a Mount the CD ROM on the remote system using the appropriate mo unt command listed in the mount command table in the section CD ROM Installation Procedure on page 1 6 b Configure the remote system so that the CD ROM drive is available for mounting on your local system i e exporting Choose the appropriate export instructions for your platform from the table 1 21 1 Installing MATLAB on UN IX W orkstations A Platform Export Instructions Sun SunOS 4 x Sun Solaris 2 x HP 9000 HP U X DEC Alpha Digital UNIX RS 6000 AI X SGI IRIX Linux Add the line to the exports file et c exports
47. ur file system for symbolic links to the mat ab and mex scripts Choose a directory such as usr local bin that is common to all your users paths Specify a location in your file system for mat ab and mex man pages Provide your MATLAB License Number This number is provided on your packing list look for your SitelD number or with your passcodes If you do not know what this number is enter the word unknown Note TheLicense Number allows The MathWorks to reference your account when you call for technical support or other service The MATLAB license command displays its value If you need to change the value at a later time simply reinstall or edit thefile MATLAB toolbox matlab local license m Select OK to continue 12 TheStart Installation screen is displayed Select OK to start the installation After the installation is complete the Installation Complete screen is dis 1 12 M ATLAB Installation Procedure played assuming your MATLAB installation is successful Select Exit to exit from the setup program 13 Follow the directions in the table below to insert a Bourne shell code frag ment into a UNI X boot script on your system This automatically starts the license manager daemons at boot time Create any indicated files that do not already exist For security reasons you cannot start up the license manager when logged in as superuser Within the boot scripts provided below you must provide the user name of some
48. x or e mail that you received from The MathWorks The specific items you must match for each FEATURE line are Expiration date Number of keys Passcode Hostid if a feature is CPU locked Toavoid warning messages appearing in the log file upon startup delete all FEATURE lines associated with products that you are not using For more information see the complete description of the i cense dat file that appears in License Manager Administration on page 1 2 After you have finished editing thel i cense dat file press the OK button to continue 1 10 M ATLAB Installation Procedure Note If you prefer to use your own editor press Cancel and then invoke your editor on thefile MATLAB etc license dat to make the changes 10 The Installation Options screen is displayed Cations Select any additional platforms needed at your site if you havea floating net work license Remove or add any software options by highlighting the item s and pressing the appropriate button 1 11 1 Installing MATLAB on UN IX W orkstations 11 The Installation Data screen is displayed ayha be aud mek oripa Specsty dimctery to pul m al dan F data ATLAR man gases Specety for man paget jusriescus manti Fimer ner your MATLAB Licmuos Hg Prese the Help betina Ber in onna ced These jiems Specify the location in yo
49. xample if most of your users use MATLAB on a single computer on your network you can request an unlimited licenseto run MATLAB on that computer plus a small number of keys to float among the other workstations in your network This licensing arrangement is represented in your license file by a FEATURE line for an unlimited user node locked license followed by an NCREMENT line for a four user floating license as in this example FEATURE MATLAB MLM 5 01 jan 1997 0 0123456789ABCDEF1234 HOSTI D 7260d091 INCREMENT MATLAB MLM 5 01 jan 1997 4 0123456789ABCDEF1234 License M anager Administration Tool mboot mcksum mdebug mdi ag mdlog md own mhostid mr emove mr er ead mstart mstat mver Demo Licenses TheFEATURE line for a demo license has the form FEATURE feature MLM 5 expirdate 0 passcode HOSTI D DEMO Becausethis type of license allows an unlimited number of users to run on any CPU in the network theusers field is set to0 and hostid is set to DEMO Here is an example of a demo license for SIMULINK expiring on J anuary 1 1997 FEATURE SI MULI NK MLM 5 01 jan 1997 0 0123456789ABCDEF1234 HOSTI D DEMO License Administration Tools A number of license administration tools are available MATLAB et c Description Start license daemons at boot time Producel i cense dat file checksums Generate diagnostic report and optionally e mail to The MathWorks to help troubleshoot problems related to
Download Pdf Manuals
Related Search