Home

System Administrator Guide (Windows)

Contents

1. REStarted xxx internet port nnn Vendor daemon xxx was restarted at internet port nnn Retrying socket bind address in use The license servers try to bind their sockets for approximately 6 minutes if they detect address in use errors Selected EXISTING master node This license daemon has selected an existing master node as the master n ERVER shutdown requested A daemon was requested to shut down through a user generated kill command NEW Server started for feature list A possibly new server was started for the features listed Shutting down xxx The license daemon is shutting down the vendor daemon xxx SIGCHLD received Killing child servers A vendor daemon logs this message when a shutdown was requested by the license daemon National Instruments Corporation 5 15 MATRIXx System Administrator Guide Windows Chapter 5 FLEXIm Licensing Tools Started name The license daemon logs this message whenever it starts a new vendor daemon Trying connection to node The daemon is attempting a connection to node Configuration Problem Messages hostname Not a valid server host exiting This daemon was run on an invalid hostname hostname Wrong hostid exiting The host ID is wrong for hostname BAD CODE for feature name The specified feature name has a bad encryption code CANNOT OPEN
2. Using the borrowing interface in application if provided in the application e Setting the LM BORROW environment variable directly O National Instruments Corporation 5 5 MATRIXx System Administrator Guide Windows Chapter 5 FLEXIm Licensing Tools Clearing the Borrowed License Setting To clear the LM_BORROW setting in the registry issue the command lmborrow clear Clearing the LM_BORROW setting stops licenses from being borrowed until borrowing is initiated again A user might run 1mborrow clear after he has borrowed licenses for features that are used offline if before disconnecting from the network he wants to run an application that checks out additional features served by vendor that are not meant to be borrowed Clearing LM BORROW does not change the status for already borrowed licenses Determining Borrowed License Status To print information about borrowed features issue the following command on the machine from which they are borrowed lmborrow status The borrowing system does not have to be connected to the network to determine the status Returning a Borrowed License Early To return a borrowed license early first reconnect the borrowing system back to the network and then from the same machine that initiated the borrowing issue the command lmborrow return c license file list c display feature where c licesne file list Use the specified license file s In some configurations th
3. c license file t timeout s interval b l logfile where app Is required for Windows systems c license file Uses the specified license file t timeout Sets a timeout interval in seconds during which redundant daemons must complete their connections to each other The default value is 10 seconds A larger value may be desirable if the daemons are being run on busy systems or a heavily loaded network s interval Specifies the logfile timestamp interval in minutes The default is 360 minutes 1 logfile Specifies the pathname to the log file If this option is not specified the log will be sent to standard output v Prints the 1mgrd version number Imstat The 1mstat utility helps you monitor the status of all network licensing activities including Which daemons are running e Users of individual features e Users of features served by a specific daemon Syntax is lmstat a S DAEMON f feature s server name t value c license file A 1 regular expression where a Displays everything A Lists all active licenses MATRIXx System Administrator Guide Windows 5 2 ni com Imreread Chapter 5 FLEXIm Licensing Tools c license file Uses license file S DAEMON Lists all users of the specified daemon s features f feature name Lists users of the specified feature s 1 regular Lists users of matching license s expression s server na
4. eese nen enne enne 5 5 Clearing the Borrowed License Setting sess 5 6 Determining Borrowed License Status sess 5 6 Returning a Borrowed License Early ees 5 6 mute A eiae 5 7 too src tica 5 7 Configuration Using License File een 5 8 Configuration Useing Services sse 5 8 Resolving Problems ec e Re p aid 5 8 General Debus Sings Tipsiss is aoo e aii e 5 8 Support Issues eo ne epit d Pe pets 5 9 Troubleshooting License Manager Problems oooconncnocnnonnonnnonconcnnnonncnnncnnornnonncnnncnnornno 5 10 Host ID Problems re n e es 5 10 Connection Problems toe RP rtt tna 5 11 Other Chent Problems tente eee delete ect teet deg 5 12 Other Server Problems citar tit me RE RES 5 12 Daemon Los Flete 5 14 Informational Messages oie 5 14 Configuration Problem Messages cccsceesssseeseeseceseeseeesecesesesseeeseseeeeaee 5 16 Daemon Software Error Messages sse 5 17 Appendix A Technical Support and Professional Services National Instruments Corporation Vii MATRIXx System Administrator Guide Windows About This Manual Organization This manual tells how to install MATRIXx product family version 7 x Conventions This manual includes the following e Chapter 1 Installation Overview and Platform Requirements defines the version 7 x installation and platform requireme
5. HARDWARE COMPATIBILITY PROBLEMS MALFUNCTIONS OR FAILURES OF ELECTRONIC MONITORING OR CONTROL DEVICES TRANSIENT FAILURES OF ELECTRONIC SYSTEMS HARDWARE AND OR SOFTWARE UNANTICIPATED USES OR MISUSES OR ERRORS ON THE PART OF THE USER OR APPLICATIONS DESIGNER ADVERSE FACTORS SUCH AS THESE ARE HEREAFTER COLLECTIVELY TERMED SYSTEM FAILURES ANY APPLICATION WHERE A SYSTEM FAILURE WOULD CREATE A RISK OF HARM TO PROPERTY OR PERSONS INCLUDING THE RISK OF BODILY INJURY AND DEATH SHOULD NOT BE RELIANT SOLELY UPON ONE FORM OF ELECTRONIC SYSTEM DUE TO THE RISK OF SYSTEM FAILURE TO AVOID DAMAGE INJURY OR DEATH THE USER OR APPLICATION DESIGNER MUST TAKE REASONABLY PRUDENT STEPS TO PROTECT AGAINST SYSTEM FAILURES INCLUDING BUT NOT LIMITED TO BACK UP OR SHUT DOWN MECHANISMS BECAUSE EACH END USER SYSTEM IS CUSTOMIZED AND DIFFERS FROM NATIONAL INSTRUMENTS TESTING PLATFORMS AND BECAUSE A USER OR APPLICATION DESIGNER MAY USE NATIONAL INSTRUMENTS PRODUCTS IN COMBINATION WITH OTHER PRODUCTS IN A MANNER NOT EVALUATED OR CONTEMPLATED BY NATIONAL INSTRUMENTS THE USER OR APPLICATION DESIGNER IS ULTIMATELY RESPONSIBLE FOR VERIFYING AND VALIDATING THE SUITABILITY OF NATIONAL INSTRUMENTS PRODUCTS WHENEVER NATIONAL INSTRUMENTS PRODUCTS ARE INCORPORATED IN A SYSTEM OR APPLICATION INCLUDING WITHOUT LIMITATION THE APPROPRIATE DESIGN PROCESS AND SAFETY LEVEL OF SUCH SYSTEM OR APPLICATION Contents About This Manual Organization UC E E ix CEOTIV
6. NI recommends against using unsupported compilers Minimum Disk Space Requirements The minimum space requirements for the MATRIXx software on a Windows host are shown in Table 1 3 A complete installation requires approximately 135 MB of disk space during the MATRIXx installation process This may be significantly larger for large disk partitions that use a FAT format Table 1 3 Minimum Disk Space Requirements Product Space Required MATRIXx 135 MB License Manager 5MB Altia Design Animation optional 45 MB Altia FacePlate optional 25 MB Full installation 210 MB National Instruments Corporation 1 3 MATRIXx System Administrator Guide Windows Chapter 1 Installation Overview and Platform Requirements Installation Configurations MATRIXx supports three installation types on Windows hosts standard server and client A PC can only support one of these installation types at a time for a given version of MATRIXx If you want to change installation types for a version you should uninstall and then reinstall that version Multiple different versions of MATRIXx software can be installed at one time on the same machine including different installation types MTXHOME license dat Windows XP Client Figure 1 1 Typical Client Server Configuration Standard Installation A standard installation installs the full set of MATRIXx software on the local Windows system Typical
7. license Usage is lmdiag c license file n feature where c 1icense file path to file to diagnose n run in noninteractive mode Imdiag will not prompt for any input in this mode In this mode extended connection diagnostics are not available Feature diagnose this feature only If no feature is specified 1mdiag will operate on all features in the license file s in your path 1mdiag will first print information about the license then attempt to check out each license If the checkout succeeds Imdiag will indicate this If the checkout fails 1mdiag will give you the reason for the failure If the checkout fails because 1mdiag cannot connect to the license server then you have the option of running extended connection diagnostics These extended diagnostics attempt to connect to each port on the license server node and can detect if the port number in the license file is incorrect 1mdiag will indicate each port number that is listening and if it is an lmdiag process 1mdiag will indicate this as well If 1mdiag finds the vendor daemon for the feature being tested then it will indicate the correct port number for the license file to correct the problem 1mver reports the FLEXIm version of a library in binary Usage is lmver filename where filename can be nilm exe or Imgrd exe 1mborrow supports borrowing of licenses that contain the BORROW attribute It must be run on the machine where licenses are borrowed I
8. mtxdemo or mtxhelp and version is one of the versions in installation directoryNbin The version string appears as a suffix on the launching scripts Recording Your Reference Number To help us provide rapid support when you call National Instruments the installation procedure prompts you for the 10 character reference number while installing MATRIXx 7 x or the license manager Your reference number is stored in the file MTXHOMES NILM config txt If you do not have a reference number you can obtain one from National Instruments when you request your Authorization Key and enter it into the first line of the config txt file as follows REFERENCE NUMBER 10_character_string You can use the Xmath NIREFNUM command to display the reference number Moving the MTXHOME Directory Tree to Another Directory If you want to move the MTXHOME directory tree to another directory after installing MATRIXx version 7 x the preferred method is as follows 1 Save the License dat file if required 2 Uninstall the MATRIXx software after stopping the license daemon 3 Reinstall MATRIXx in the new directory location 4 Copy the license dat file to the new directory location 5 Restart the license daemon Configuration Management Tasks The MATRIXx configuration management CM utility provides integration between SystemBuild and the ClearCase Merant PVCS Perforce and Microsoft Visual SourceSafe CM tools Before using
9. In addition it can provide the required licensing installation on single or redundant license servers National Instruments Corporation 4 7 MATRIXx System Administrator Guide Windows Chapter 4 Installation and Related Tasks Installation Procedure Before running the installation program you will need the NI reference number authorization key and checksum 1 Place the version 7 x CD in the CD ROM drive 2 Use the Windows Explorer to find the setup exe file in the NILM directory and launch it 3 Select the Install License Manager setup type and follow the dialog prompts to complete the installation 4 Each installation of MATRIXx installed in a separate location can access the license server via the proxy license file described in the Proxy License Files section of Chapter 3 Licensing and Terminology Installing Redundant License Servers At a minimum installing redundant license servers requires the installation of standalone license manager software and starting the license manager daemon on two other nodes in addition to the primary license server Special license keys are required for a redundant license server configuration To install a typical redundant license server configuration complete the following steps 1 Perform a standalone license manager installation on the primary license server refer to Installing the Standalone License Manager section or a complete MATRIXx installation if you want this
10. by semi colons Pathnames which include spaces have tobe enclosed in double quotes y Prints the FLEX m version of the utility verbose Prints the description for all errors found The output from the utilities may be harder to read with this option but is useful for diagnostics v6 0 only Imtools For the 32 bit Windows platforms a graphical user interface to the license manager tools is provided called LMTOOLS Always use the newest version of LMTOOLS as possible it is available for download from www macrovision com O National Instruments Corporation 5 7 MATRIXx System Administrator Guide Windows Chapter 5 FLEXIm Licensing Tools Some of the functions LMTOOLS performs include e Starting stopping and configuring FLEXIm license servers e Getting system information including hostids e Getting server status LMTOOLS has two modes in which to configure a license server e Configuration using a license file e Configuration using services Configuration Using License File Operations are performed on a particular license file The file can be either local or remote In this mode you cannot start the 1mgr process but you can do everything else To configure this mode perform the following 1 Invoke LMTOOLS 2 Click the Configuration using License File radio button 3 Enter one or more the license file names or port host specifications Configuration Useing Services Operations are performe
11. machine to also serve the MATRIXx application files refer to the Version 7 x Installation section Either procedure requires generating a license file and starting the license daemon 2 On each of two secondary license servers run either the standalone license manager installation refer to the Installing the Standalone License Manager section or a complete MATRIXx installation if you want to replicate all the MATRIXx files and then start the license daemon on each machine B Note Rather than generating the license file on each secondary license server copy license dat from the NILM directory of the primary server to the NILM directory of each secondary server before starting the license daemons Edit the DAEMON line of each secondary copy of the license dat file to point to the daemon path that contains nilm exe for that server MATRIXx System Administrator Guide Windows 4 8 ni com Chapter 4 Installation and Related Tasks 3 Each separate installation of MATRIXx can access the license server with a proxy license file as described in the Proxy License Files section of Chapter 3 Licensing and Terminology Updating a License File To update a license file run the standalone license manager installation as described in the Installing the Standalone License Manager section and select the Update License File setup type Using Online Help MATRIX x version 7 x provides a hypertext markup language HTML help system MAT
12. reproduced or transmitted in any form electronic or mechanical including photocopying recording storing in an information retrieval system or translating in whole or in part without the prior written consent of National Instruments Corporation Trademarks AutoCode DocumentIt MATRIXx National Instruments NI ni com SystemBuild and Xmath are trademarks of National Instruments Corporation Product and company names mentioned herein are trademarks or trade names of their respective companies Patents For patents covering National Instruments products refer to the appropriate location Help Patents in your software the patents txt file on your CD or ni com patents WARNING REGARDING USE OF NATIONAL INSTRUMENTS PRODUCTS 1 NATIONAL INSTRUMENTS PRODUCTS ARE NOT DESIGNED WITH COMPONENTS AND TESTING FOR A LEVEL OF RELIABILITY SUITABLE FOR USE IN OR IN CONNECTION WITH SURGICAL IMPLANTS OR AS CRITICAL COMPONENTS IN ANY LIFE SUPPORT SYSTEMS WHOSE FAILURE TO PERFORM CAN REASONABLY BE EXPECTED TO CAUSE SIGNIFICANT INJURY TO A HUMAN 2 IN ANY APPLICATION INCLUDING THE ABOVE RELIABILITY OF OPERATION OF THE SOFTWARE PRODUCTS CAN BE IMPAIRED BY ADVERSE FACTORS INCLUDING BUT NOT LIMITED TO FLUCTUATIONS IN ELECTRICAL POWER SUPPLY COMPUTER HARDWARE MALFUNCTIONS COMPUTER OPERATING SYSTEM SOFTWARE FITNESS FITNESS OF COMPILERS AND DEVELOPMENT SOFTWARE USED TO DEVELOP AN APPLICATION INSTALLATION ERRORS SOFTWARE AND
13. to run two different versions of the application program and the software vendor has not specifically set up the new version for this kind of compatibility Check the license server log file for a comm version mismatch warning message this indicates that someone is running a V1 5 client with a V2 1 or later license server Run only the new version of the application or only the old version When I start Imgrd it says Retrying socket bind address in use port xxxx The license server listens on the port xxxx that has already been used by another server program 99 44 of the time if it s in use it s because 1mgrd from NI or another vendor is already running on the port or was recently killed and the port isn t freed yet 5 12 ni com solution Chapter 5 FLEXIm Licensing Tools In the License dat file NI has put 27000 at the end of the SERVER line as the port number You can remove it to let 1mgrd scan for a free port from 27000 to 27009 You can also specify a port number selected by yourself for other concerns like farewell N Caution The portscan feature of Imgrd is only available for FLEXIm v6 licenses You cannot drop the port numbers when configuring redundant servers symptom cause solution symptom cause O National Instruments Corporation When I start up 1mgrd itsays execl failed on my vendor daemon lmgrd uses exec to start each vendor daemon running If there is a problem starting the
14. txt case demos perl sysbld version xmath debuglog CASE SYSBLD XMATH license dat ACA Imhostid exe r aerolib env bin Imgrd exe p Ace bin demos basic xmath bat is Diis abs j control l bin u sbsim bat etc etc dsp autostar bat etc examples examples _ ai i i hel ia bat L icons ep icdm encrypt bat L dib include mtxdemo bat lib r ifilter palettes isid mtxhelp bat Lgs diles sre modelReduction SIC tools startup neuralnet sms readme txt optimize relnotes txt L robust Note version has the form 7x x version dat L xmu v6support txt Figure 2 1 MATRIXx Product Family Sample File Structure MATRIXx System Administrator Guide Windows 2 2 ni com Licensing and Terminology This chapter provides an overview of licensing and describes licensing related terminology and tasks Version 7 x includes a license daemon 1mgrd exe which controls all National Instruments product licenses lmgrd exe resides in the directory NILM and must be running on your license server or on all three if you have a redundant license server configuration It does not have to be on the node where you install version 7 x Licensing Overview MATRIX x licensing includes the following features e Floating and node locked licenses e Redundant license servers optional e Flexible license checkout Floating and Node Locked Licenses License
15. x software MATRIXx System Administrator Guide Windows 4 14 ni com FLEXIm Licensing Tools This chapter describes the FLEXIm utilities This includes explaining how to troubleshoot common license manager problems and describes messages from the daemon log file For additional licensing documentation refer to the FLEXIm End User Manual from Macrovision Corporation on the MATRIXx documentation CD FLEXIm Utilities MATRIXx Product Family version 7 x uses FLEXIm for its license server FLEXIm provides the following utilities to help manage the licensing activities on the network Imstat Helps you monitor the status of all network licensing activities lmdiag Lets you diagnose problems when you cannot check out a license lmgrd Starts the license daemon lmhostid Reports the host ID of a system lmreread Causes the license daemon to reread the license file and start any new vendor daemons lmver Reports the FLEXIm version of a library or a binary lmborrow Supports license borrowing lmutil FLEXIm license server management and administration lmtools Graphical user interface for FLEXIm utilities Imgrd lmgrd is the main daemon program for FLEXIm When you invoke 1mgrd it looks for the license file The license file contains information about vendors and features National Instruments Corporation 5 1 MATRIXx System Administrator Guide Windows Chapter 5 FLEXIm Licensing Tools Syntax is lmgrd app
16. Altia code words file after installation is complete to identify the path of the NI license manager file License dat Select Start Programs Altia Design Codeword File and specify the path to the MATRIXx license file Installing Altia FacePlate Because the Altia FacePlate software uses the MATRIXx license manager you must have either MATRIXx or the standalone license manager installed E To install Altia FacePlate software complete the following steps 1 2 Verify that the MATRIXx CD is in your CD ROM drive Use the Windows Explorer to find the setup exe file in the Altia Face directory and launch it When the installation dialog prompts you for the installation directory specify MTXHOME where MTXHOME is your existing MATRIXx installation directory Note Ifyou choose not to install within your current MTXHOME directory you must edit the Altia code words file after installation is complete to identify the path of the NI license manager file License dat Select Start Programs Altia FacePlate Codeword File and specify the path to the license file Installing the Standalone License Manager The standalone license manager installation which populates only the NILM subdirectory tree is a subset of the full MATRIXx installation It can be used to provide support for other standalone product installations such as Altia animation which require MATRIXx licensing but may not need the full MATRIXx product set to function
17. EMUIGTAS 5 dss 55 sec toti oH WEIN GN uisi ced Ie ix Format Conventions ti iS x Code Examples or Program Output sese X Symbol Conventions eee teet reb e EAE huubevdebvedvevesbons X Environment Variables oooooooccnnnococnncnooonananonononancnoconnnnnnoncnonanananoos x Related Publications 2 5 ete GC I EB ee xi Chapter 1 Installation Overview and Platform Requirements Installation Overview 15 eti rentrer e iege italia 1 1 Platform Requirements ai eR AO HERR idad 1 1 Hardware Requirements orte Re dnt oe ipei 1 2 Software Requirements ooooonoccooccononnnonnconcnononnnonnnnn ocn ncnn non nonn non nonn a aa eene 1 2 Compatible Compilers and Operating System Versions ssss 1 3 Minimum Disk Space Requirements sese 1 3 Installation Configurations snesena iaiia gre i e iet dips 1 4 Standard Installation eese eene nennen 1 4 Server Installation isis i iret ea eR tine 1 5 Client Installation AA ett tete den ET reete dp 1 5 Licensing sai out Uu P E EE Do no ur etn ep SE 1 5 Troubleshooting Information eeeeeeseeeeeeeeeeeneene nennen nennen eterne 1 5 Chapter 2 Software Structure Planning OpUons eene ee tei heap tet etd e eed teste et 2 1 Directory StE CfUEe dur el e t ti 2 1 Chapter 3 Licensing and Terminology Licensing OV rview s i pede alba redu 3 1 Floating and Node Locked Licenses oooonococnnonnonn
18. EXIm Licensing Tools NO DAEMON lines exiting The license daemon logs this message if there are no DAEMON lines in the license file Since there are no vendor daemons to start there is nothing to do NO DAEMON line for name A vendor daemon logs this error if it cannot find its own DAEMON name in the license file Daemon Software Error Messages select message An error in a select system call was detected Server exiting The server is exiting This is normally due to an error National Instruments Corporation 5 17 MATRIXx System Administrator Guide Windows Technical Support and Professional Services Visit the following sections of the National Instruments Web site at ni com for technical support and professional services Support Online technical support resources at ni com support include the following Self Help Resources For immediate answers and solutions visit the award winning National Instruments Web site for software drivers and updates a searchable KnowledgeBase product manuals step by step troubleshooting wizards thousands of example programs tutorials application notes instrument drivers and so on Free Technical Support All registered users receive free Basic Service which includes access to hundreds of Application Engineers worldwide in the NI Developer Exchange at ni com exchange National Instruments Application Engineers make sure every que
19. MATRIX System Administrator Guide Windows Wy NATIONAL April 2004 Edition P INSTRUMENTS Part Number 371149A 01 Worldwide Technical Support and Product Information ni com National Instruments Corporate Headquarters 11500 North Mopac Expressway Austin Texas 78759 3504 USA Tel 512 683 0100 Worldwide Offices Australia 1800 300 800 Austria 43 0 662 45 79 90 0 Belgium 32 0 2 757 00 20 Brazil 55 11 3262 3599 Canada Calgary 403 274 9391 Canada Ottawa 613 233 5949 Canada Qu bec 450 510 3055 Canada Toronto 905 785 0085 Canada Vancouver 514 685 7530 China 86 21 6555 7838 Czech Republic 420 224 235 774 Denmark 45 45 76 26 00 Finland 385 0 9 725 725 11 France 33 0 1 48 14 24 24 Germany 49 0 89 741 31 30 Greece 30 2 10 42 96 427 India 91 80 51190000 Israel 972 0 3 6393737 Italy 39 02 413091 Japan 81 3 5472 2970 Korea 82 02 3451 3400 Malaysia 603 9131 0918 Mexico 001 800 010 0793 Netherlands 31 0 348 433 466 New Zealand 0800 553 322 Norway 47 0 66 90 76 60 Poland 48 22 3390150 Portugal 351 210 311 210 Russia 7 095 783 68 51 Singapore 65 6226 5886 Slovenia 386 3 425 4200 South Africa 27 0 11 805 8197 Spain 34 91 640 0085 Sweden 46 0 8 587 895 00 Switzerland 41 56 200 51 51 Taiwan 886 2 2528 7227 Thailand 662 992 7519 United Kingdom 44 0 1635 523545 For further support information refer to the Technical Support and Professional Services appendix To comment on the documentation send email to cte
20. MENTS omen The version 7 x software has an option for running redundant servers If you are using the redundant server option you will also be prompted to enter the hostnames of the additional license servers After you enter valid data the License File dialog not shown displays the generated license file C You will be prompted to start the license server unless you have an evaluation license Start License Server 2 Do you want to start the license server now If you answer NO you can start the license server later from the MATRIX License Server icon in the Control Panel O National Instruments Corporation 4 5 MATRIXx System Administrator Guide Windows Chapter 4 Installation and Related Tasks B Note The license server is not required for an Evaluation license For other licenses the license server can always be started later using the command 1mgrd c licesne dat 1 debug log 8 Upon completion you can select to display the README file an ASCII version of the release notes that are also available in the MATRIXx Help or exit the installation 3 Note In most cases rebooting is not necessary but Setup will prompt you to reboot if required If you have just completed a server installation be sure to set your desired access permissions for the MTXHOME directory share 9 10 11 If you are installing redundant license servers complete the procedure described in the Installing R
21. RIXx Help is a self contained system with multiple hypertext links from one component to another This help system augmented by online and printed manuals covers most MATRIXx topics except for installation MATRIXx Help runs with Internet Explorer Printing Files To print a Help topic go to the Topics Hierarchy and select a topic for example Dynamic Systems Control Design and then right click and hold An Internet Explorer window displays with one of the options saying Open Frame in New Window When the Help topic is in the new window select Print or any other standard Internet Explorer capability Installation Related Tasks Setting Up a User Environment for Printing The environment variable XMATH PRINTS defines the printer for MATRIXx The following are sample definitions for XMATH PRINT where pluto hp4 should be replaced by your printer Set the following using the Control Panel system applet set XMATH PRINT MATRIXX VxmathMbinN xmprint pluto hp4 National Instruments Corporation 4 9 MATRIXx System Administrator Guide Windows Chapter 4 Installation and Related Tasks Running Multiple MATRIXx Versions You can install multiple versions of MATRIXx version 6 x or later under a common directory If you have multiple versions installed the following command lets you run a selected version installation directoryMbinNcommand name v version where command nameis xmath sbsim autostar ia encrypt
22. Use The default port number used in MATRIXx 7 x license files is 27001 whereas for prior releases it was 5200 A valid number is any unused port number between 1025 and 64000 Beginning with MATRIXx 7 x the port number can be removed and the FLEXIm license manager will serve on any available FLEXIm reserved port in the range 27000 27009 For redundant license servers however you must use a fixed port number The path to the vendor daemon executable on the DAEMON line The vendor daemon is named ni 1m name value pairs on a FEATURE line can be changed if name is lowercase Redundant license server files contain three SERVER lines The first SERVER line defines the primary license server The second and third lines define the secondary license servers National Instruments Corporation 3 7 MATRIXx System Administrator Guide Windows Chapter 3 Licensing and Terminology Proxy License Files Compatibility If you are using a floating license server each licensing client needs a copy of the same license file used by the server Alternatively to avoid copying the license server file to each installation of MATRIXx you can create a proxy license file in the NILM directory of each MATRIXx installation This approach can be used for both single and redundant license server configurations The proxy license file License dat can be constructed by taking the SERVER line or lines from the license server file and then adding a l
23. ating 10 SystemBuild sysbld 31 jan 2002 Floating 10 AutoCode C Single Processor acc 31 jan 2002 Node Locked 4 80379b46 Model Reduction Module Modred 31 jan 2002 Floating 10 Interactive Animation Module Icdm 31 jan 2002 Floating 10 Robust Control Module Robust 31 jan 2002 Floating 10 RT Fuzzy Module blk fuz 31 jan 2002 Floating 10 AutoCode Ada Single Processor aca 31 jan 2002 Floating 10 DocumentIt docit 31 jan 2002 Node Locked 4 80379b46 LICENSEFILE The LICENSEFILE command displays the current license file search path The syntax and example output are as follows LICENSEFILE License files searched by MATRIXx are as follows butters ni NILM license dat butters ni NILM tplic dat NIREFNUM The ISIREFNUM command displays the reference number also known as your customer identification number You should have this number ready if you plan to call customer support The syntax and example output are as follows NIREFNUM Your NI Reference Number is CUSTOMID99 National Instruments Corporation 3 5 MATRIXx System Administrator Guide Windows Chapter 3 Licensing and Terminology Using Licensing With concurrent licensing you can have a different number of licenses for each module or application An application or module is either available on a first come first served basis or node locked to a given CPU Some common uses of licensing are as follows e To see all the feature
24. chpubseni com O 2000 2004 National Instruments Corporation All rights reserved Important Information Warranty The media on which you receive National Instruments software are warranted not to fail to execute programming instructions due to defects in materials and workmanship for a period of 90 days from date of shipment as evidenced by receipts or other documentation National Instruments will at its option repair or replace software media that do not execute programming instructions if National Instruments receives notice of such defects during the warranty period National Instruments does not warrant that the operation of the software shall be uninterrupted or error free A Return Material Authorization RMA number must be obtained from the factory and clearly marked on the outside of the package before any equipment will be accepted for warranty work National Instruments will pay the shipping costs of returning to the owner parts which are covered by warranty National Instruments believes that the information in this document is accurate The document has been carefully reviewed for technical accuracy In the event that technical or typographical errors exist National Instruments reserves the right to make changes to subsequent editions of this document without prior notice to holders of this edition The reader should consult National Instruments if errors are suspected In no event shall National Instruments be liable for a
25. configurations for counted floating licenses node locked licenses and evaluation licenses are available on Windows 2000 NT XP systems To check out a floating license or counted node locked licenses a client system must be connected to the network and have properly functioning TCP IP software with Winsock support Evaluation and uncounted node locked licenses do not require that you have a running license server or network support Windows 2000 NT XP systems can check out floating licenses from either a Windows 2000 NT XP or UNIX license server To check out licenses from a network license server a Windows system must reference a copy of the same license dat file used by the network server or it must reference a proxy license file refer to the Proxy License Files section Redundant License Servers Redundant license servers are a set of three nodes designated to serve the same license file If any node fails the other two nodes will still be available to serve the licenses for MATRIXx National Instruments Corporation 3 1 MATRIXx System Administrator Guide Windows Chapter 3 Licensing and Terminology To support the redundant license server scheme National Instruments requires the following information for the three servers the computername and hostid that is an Ethernet address for each server Windows 2000 NT XP systems can check out floating licenses from redundant systems containing any combination of Windows and UNIX
26. d on a service which allows starting 1mgrd processes local to the system on which LMTOOLS is running On 2000 NT XP you configure a Windows Service On Windows 95 98 you configure a FLEX m service that behaves similarly to a Windows service Resolving Problems This section offers some general debugging tips and discusses information you should gather before contacting support The Troubleshooting License Manager Problems section lists common license manager problems users have encountered before General Debugging Tips The following are tips for debugging Examine the 3MTXHOME NILM debug log file e Ifyou cannot check out a feature run SMTXHOMES NILM 1lmdiag c MTXHOME S NILM license dat MATRIXx System Administrator Guide Windows 5 8 ni com Support Issues Chapter 5 FLEXIm Licensing Tools Tf the license daemon appears to have started correctly which you should be able to determine from the ni 1og file try running lmstat to see if that program has the same problem as your application lmstat a c MTXHOME NILM license dat When you make a support call please be prepared to answer the following questions O National Instruments Corporation What kind of machine is your license daemon running on What version of the operating system is the application running on What version of FLEXIm does the program use Use the following command on your nilm vendor daemon and application SMTXHOMES NILM I
27. e license file needs to be specified in order to return the license file early d display Used to specify the diaply from whch the borrow was initiated Required if you current display is different than what was used to initiate the borrow On Windows it is the system name or in the case of a terminal server environmnet the termial server client name MATRIXx System Administrator Guide Windows 5 6 ni com Chapter 5 FLEXIm Licensing Tools feature The name of the borrowed feature to be returned early User Imborrow status to get a list of borrowed feature names Returning the license early has the effect of clearing the LM_BORROW setting for the vendor daemon that serves the returned license If the borrowing system is not placed back on the network before attempting the early return the license is not returned and LM BORROW 1s kept intact Additionally an error message is issued to the end user with notification thatthe system needs to be connected to the network Imutil The following are valid arguments for most 1mut il utilities c license file path Most imutil utilities need to know the path to the license file This is specified witha c license file path argument or by setting the LM LICENSE FILE environment variable Otherwise the default location is used The utilities also honor all VENDOR LICENSE FILE environment variables Some utilities take more than one license file path in a license file list separated
28. e to see if any problems are reported particularly messages indicating that the vendor daemon has quit Run 1mstat a from the server machine to verify that the vendor daemon is alive Run lmstat a from the client machine to verify the connection from client to vendor daemon across the network Try using telnet hostname portnum where hostname and portnum are the same as on the server line in your license file National Instruments Corporation 5 11 MATRIXx System Administrator Guide Windows Chapter 5 FLEXIm Licensing Tools Other Client Problems symptom cause solution symptom cause solution Other Server Problems symptom cause MATRIXx System Administrator Guide Windows When I run my application program or vendor daemon I get the error bad code Possible causes for this are 1 The license file was modified either the host ID on a server line or anything on the feature line was changed 2 The vendor used the wrong version of his license creation program to generate your license file or there is a bug in that process You cannot modify the license file If you need to change something in your license file you must get a new license from National Instruments When the second user tries to check out a license the vendor daemon prints an error concerning Parameter mismatch in the log file and refuses the license The most likely cause of this problem is that you are simultaneously trying
29. edundant License Servers section To start Xmath version 7 x select Start National Instruments MATRIXx mx 71 1 Xmath orenter either of the following from the command prompt installation directoryNMbinNxmath or installation directoryYbinixmath v version where version is the installation version that you just installed or one of the versions in installation directoryWbin Optional After you have verified that Xmath starts successfully go to the Installing Other Components section if you plan to use Altia Design animation or Altia FacePlate Installing Other Components This section describes the installation procedures for installing optional MATRIXx components Installing Altia Design Animation Because the Altia Design software uses the MATRIXx license manager you must have either MATRIXx or the standalone license manager installed MATRIXx System Administrator Guide Windows 4 6 ni com 3 Chapter 4 Installation and Related Tasks To install Altia Design animation software complete the following steps 1 2 Verify that the MATRIXx CD is in your CD ROM drive Use the Windows Explorer to find the setup exe file in the Altia Design directory and launch it When the installation dialog prompts you for the installation directory specify MTXHOME where MTXHOME is your existing MATRIXx installation directory Note Ifyou choose not to install within your current MTXHOME directory you must edit the
30. features for future use ICENSEUSER for displaying assigned licenses for any feature names specified e LICENSEINFO for displaying a license report for your site ICENSEFILE for displaying the current license file search path e ISIREFNUM for identifying your reference number All of these commands must be run from the Xmath Commands window LICENSECHECKOUT LICENSEUSER LICENSECHECKOUT is an intrinsic command that checks out a license for the listed feature or features Run LICENSEINFO to see a list of feature names Features are specified as strings and the name must be exactly as displayed by LICENSEINFO Although features are normally checked out on demand you can use LICENSECHECKOUT to reserve features for future use for example for a scheduled demo or presentation They are checked in when you exit Xmath This command can be placed in a global or local startup ms file to check out required features at startup The syntax is as follows LICENSECHECKOUT featurel feature2 featureN For example LICENSECHECKOUT Xmath Control Sysid Sysid2 sysbld case The LICENSEUSER utility displays assigned licenses for any feature names specified The default feature is Xmath 1f no argument is specified LICENSEUSER accepts feature names in string form To see a list of the feature names for products you have purchased for example aca indicates AutoCode Ada
31. fusion with the uppercase letters O I and S MATRIXx System Administrator Guide Windows 3 10 ni com Installation and Related Tasks This chapter describes how to install MATRIXx software including any optional components such as Altia Design and perform related tasks Version 7 x Installation This section provides a detailed description of how to install MATRIXx product family version 7 x software on a client server or standalone PC Requirements Your system must meet the hardware and software requirements for your platform specified in Chapter 1 Installation Overview and Platform Requirements e Floating licenses require properly functioning TCP IP networking which includes Winsock version 1 1 or later Installation Procedure Before running the installation program you will need the reference number authorization key and checksum iy Note Before beginning the installation make sure you exit from any other software and stop all virus scan software 1 Place the version 7 x CD in the CD ROM drive 2 Use the Windows Explorer to find the setup exe file in the MATRIXx directory and launch it 3 After the Welcome screen not shown the following dialog box prompts you for the location of your installation directory National Instruments Corporation 4 1 MATRIXx System Administrator Guide Windows Chapter 4 Installation and Related Tasks Choose Destination Location 4 Setup defaults t
32. h the MATRIXx installation directory You will need to complete the following steps to completely remove both the license server and the MATRIXx software 1 Stop and remove the MATRIXx License Server service from your machine complete the following steps a Select Start National Instrument MATRIXx mx 71 1 NI Licence Manager Imtools 4 13 MATRIXx System Administrator Guide Windows Chapter 4 Installation and Related Tasks b In the Start Stop Reread tab click Stop Server If a failure is reported the server may already be stopped c Onthe Config Services tab click Remove Service LMTOOLS by Macrovision Corporation http www macrovision com File Edit Mode Help Service License File System Settings Utilities Start Stop Reread Server Status Server Diags Config Services Borrowing Configure Service Save Service Service Name NILM License Manager X Path to the Imgrd exe file National Instruments MATRIKS NILMSImgrd exe Bowe Path to the license file ational Instruments MATRIX NILMSicense dat Bowe Path to the debug log file ational Instruments MATRIX SNILM debug log Browse View Log Start Server at Power Up IV Use Services 2 To remove the MATRIXx License Server and MATRIXx version 7 x software complete the following steps a Use Control Panel Add Remove Programs to remove the MATRIXx License Server b Use Control Panel Add Remove Programs to remove the MATRIXx version 7
33. he license file Symptoms of external program failure are that the MATRIXx launching scripts do not have the correct installation path set in environment variables such as MTXHOMES thus causing Xmath and other programs to fail to launch If license file generation fails during an install Xmath may report a license file error when trying to run It is possible to run the external programs from the command line after an install to fix these problems without performing a complete reinstall You can invoke each of the two programs listed below without providing parameters to get a usage message that describes the required command line arguments To generate a new license file from the Command Prompt window change directory to amp MTXHOMES NNILM and run the license file generator engine exe You should use the nolog parameter when generating the license from the command line This program replaces the license dat file in the 3MTXHOME NILM directory National Instruments Corporation 4 11 MATRIXx System Administrator Guide Windows Chapter 4 Installation and Related Tasks Toreset the installation path in the MATRIXx launching scripts run the Perl program moveinstall pl You can invoke this program as follows to get its usage description SMATRIXX perl perl exe MATRIXX version moveinstall pl where MATRIXX is the MATRIXx product subdirectory as shown in Figure 2 1 MATRIXx Product Family Sample File Structure Temp D
34. ine containing USE SERVER For example a proxy license file for a single server configuration would be as follows SERVER host1 17003456 27000 USE SERVER A proxy license file for a redundant server configuration for example would be RVER hosti 17003456 27002 SERVER host2 17004355 27002 SERVER host3 17007ea8 27002 USE SERVER SI GH nm Unless your server nodes are changed you will not have to update the license file for each individual MATRIXx installation when the server license file is updated Although a proxy license file is the preferred way to reference the actual license file used by a remote license server you can also use a port host definition for either of the environment variables NILM_LICENSE_FILE or MTXLMD_LICENSE_FILE port is the license file port number and host is the hostname and both are taken from the SERVER line of the actual license file MTXLMD_LICENSE_FILE is similar in use to NILM_LICENSE_FILE except that it is specific to the MATRIXx license manager daemon and overrides any concurrent definition of NILM_LICENSE_FILE The MATRIXx 7 x license manager uses the vendor daemon name nilm versus isilmd in prior releases and the default port number 27001 versus 27000 in prior releases As a result the MATRIXx 6 x ISILM and MATRIXx 7 x NILM license manager can coexist with MATRIXx 5 x running on the same machine Since version 6 x 7
35. irectory Usage During Install InstallShield uses the Windows TEMP folder during installations It is therefore important that sufficient disk space exist on the disk drive containing TEMP which may be different from the drive where you are installing MATRIXx An installation can fail when there is insufficient disk space on the TEMP drive On rare occasions an InstallShield install can fail due to remnants in the TEMP folder of a previously aborted install You can avoid this problem by clearing the contents of the TEMP folder License Servers The license server must be started unless you are using an Evaluation license or are using another network node as a floating license server When the license server is properly started the 1mgrd and nilm processes should appear in the process list of the Windows task manager You can use the MATRIXx License Server applet in the Windows Control Panel to start or stop the license server or to check its status You can also check the contents of the license server diagnostic log file installation directoryNNILMNdebug log to see if the license server is running correctly If the license server is running and you wish to use a different copy of the license dat file you should stop the license server first copy the new license dat file and then restart the license server If you try to perform one of the following licensing tasks and receive an error message you may be able to correct it by identif
36. issue the LICENSEINFO command The syntax for ICENSEUSER is as follows LICENSEUSER featurel feature2 featureN National Instruments Corporation 3 3 MATRIXx System Administrator Guide Windows Chapter 3 Licensing and Terminology Typical output is shown in Example 3 1 Example 3 1 LICENSEUSER output licenseuser xmath aca Users of Xmath Number of licenses purchased 10 Number of unused licenses 4 User Node Name Starting Time muemura sampras Thu May 29 19 33 44 lynch tribble Thu May 29 19 34 36 sanjay castaway Sat May 31 19 01 04 rpizzi castor Mon Jun 2 15 21 54 dawn venus Wed Jun 4 11 05 06 uma sampras Mon Jun 9 13 45 47 Users of aca Number of licenses purchased 4 Number of unused licenses 2 User Node Name Starting Time muemura sampras Thu May 29 19 56 44 uma sampras Mon Jun 9 13 51 47 MATRIXx System Administrator Guide Windows 3 4 1999 1999 1999 1999 1999 1999 1999 1999 ni com Chapter 3 Licensing and Terminology LICENSEINFO LICENSEINFO displays a license report for your site as shown in Example 3 2 Example 3 2 LICENSEINFO license report licenseinfo License File C Program FilesiNational Instruments MATRIXx mx_71 1 NILM license dat License Server Name hardrock License Server ID 18000000 Module Name Feature Name Expiration Date Type Seats Licensed Node Xmath Xmath 31 jan 2002 Floating 10 Control Design Module Control 31 jan 2002 Flo
37. license dat This primary license file contains feature lines for built in MATRIXx features The license dat file is generated from NI provided authorization keys during the MATRIX x or standalone license manager installation procedures MATRIXx System Administrator Guide Windows 3 6 ni com Chapter 3 Licensing and Terminology SMTXHOME NILM tplic dat This optional file contains license feature lines for third party MATRIXx components The encrypted feature lines in this file and the instructions for using the file will typically be provided by your third party supplier Multiple features from different third party suppliers can be placed in this file Typically this file will also contain the same SERVER and DAEMON lines as license dat This file is not modified during a MATRIXx or license manager installation nor is it deleted by uninstall procedures The search paths used to locate these license files are set in the environment variable NILM LICENSE FILES by the MATRIXx product launching scripts The above NI license file paths are prepended to any existing definition of NILM LICENSE FILES thus allowing access to other MATRIXx or non MATRIXx products also licensed by a FLEXIm license manager Normally the only things you can change in a license file are The hostname not the hostid The port number on the SERVER line If this port number is already in use the license daemon 1mgra will report Address In
38. ly this type of installation is not visible to other machines on the network because it uses a local installation path not accessible to other systems If you perform a standard install specifying the installation directory with a valid pathname in Uniform Naming Convention UNC format for example computername sharename ni MATRIXx System Administrator Guide Windows 1 4 ni com Server Installation Client Installation Licensing Chapter 1 Installation Overview and Platform Requirements then the installation will be visible to other users similar to a server installation A server installation installs the full set of MATRIXx software on the local Windows system similar to a standard installation However a server installation will if necessary automatically create a directory share with a user specified name for the local install directory thus ensuring that the software is visible to other client systems on a network A server installation can also accept a valid UNC format pathname for the installation directory path A client installation requiring only 5 KB of disk space creates shortcuts to an existing server installation of MATRIXx and updates any Windows shared system files on the client required to run the MATRIXx software It does not place any other software on the client system During a client installation of MATRIXx you will be asked to specify the network pathname of an existing MATRIXx server installatio
39. me Displays status of server node s t value Sets 1mstat time out to value The 1mreread utility causes the license daemon to reread the license file and start any new vendor daemons that have been added Additionally all pre existing daemons will be signaled to reread the license file for changes in feature licensing information Syntax is lmreread c license file iyi Note If you use the c option the license file specified will be read by 1mreread not by 1lmgrd 1mgrd rereads the file it read originally Also 1mreread cannot be used to change server node names or port numbers Vendor daemons will not reread their option files as a result of 1mreread Imhostid The 1mhostid utility reports the host ID of a system Syntax is lmhostid ether long The output of this command appears as follows lmhostid Copyright c 1989 199x Highland Software Inc The FLEX1m host ID of this machine is 69021c89 The ether option causes 1mhostid to print the Ethernet address on Hewlett Packard HP systems On HP systems the long option prints the value of the HP ID module These options are only available in FLEXIm v2 21 or later The default is long for FLEXIm v2 21 or earlier and ether for FLEXIm v2 4 or later National Instruments Corporation 5 8 MATRIXx System Administrator Guide Windows Chapter 5 FLEXIm Licensing Tools Imdiag Imver Imborrow 1mdiag allows you to diagnose problems when you cannot check out a
40. more than one copy of the daemon running Check for more than one 1mgrd running as well since it will restart your vendor daemon when it is killed If more than one 1mgrad is running kill them all then kill any remaining vendor daemons and start one fresh copy of 1mgrd Check to see whether a shell script is running that cleans out tmp If so try modifying it so that it does not delete zero length files Daemons generate log files with DAEMON NAME messages where DAEMON NAME message Either license daemon or the string from the DAEMON line that describes your daemon In the case where a single copy of the daemon cannot handle all of the requested licenses an optional underscore followed by a number indicates that this message comes from a forked daemon The text of the message The log file available as 3MTXHOME NILM debug log can be used to Inform users when they need to purchase additional application software licenses e Diagnose configuration problems e Diagnose daemon software errors Informational Messages These messages are only informational and do not necessarily indicate an error or a problem Connected to node This daemon is connected to its peer on node node CONNECTED master is name The license daemons log this message when a quorum is up and everyone has selected a master DENIED N feature to user N licenses user was denied acces
41. mver MTXHOME NILM nilm exe What error or warning messages appear in the log file Did the daemon start correctly Look for a message such as server xyz started for featurel feature2 What is the output from running 1mstat a Are you running other products which are also licensed by FLEXIm National Instruments does not support combined license files 5 9 MATRIXx System Administrator Guide Windows Chapter 5 FLEXIm Licensing Tools Troubleshooting License Manager Problems Host ID Problems MATRIXx System Administrator Guide Windows This section lists areas of FLEXIm administration that have given customers difficulty in the past Categories are Host ID Problems Connection Problems and Other Client Problems symptom cause solution When I run the license manager on my machine it tells me it is the wrong host ID The vendor daemon checks the host ID listed on the server line in the license file if it does not match the host ID of the machine it is running on this message will be printed Possible causes include 1 You are trying to run the license daemon on a different machine from the machine the file was made for 2 The host ID of the machine you are running on changed for example the HP ID module was moved or the CPU board was replaced 3 The host ID in the license file was modified Verify that the host ID of the machine where the vendor daemon or node locked client program is being ru
42. n All client machines that will use MATRIXx software must be able to access the MTXHOMES root directory on the server machine MATRIXx uses FLEXIm licensing utilities For licensing information refer to Chapter 3 Licensing and Terminology Chapter 5 FLEXIm Licensing Tools or the FLEXIm End User Manual on the MATRIXx Bookshelf Troubleshooting Information For troubleshooting tips refer to the Troubleshooting Your Installation section of Chapter 4 Installation and Related Tasks For additional troubleshooting assistance contact support ni com National Instruments Corporation 1 5 MATRIXx System Administrator Guide Windows Software Structure This chapter describes installation planning options and version 7 x directory structure Planning Options Before starting the installation you should make decisions about how and where you want to install MATRIXx tools These issues must be addressed before you start the installation procedure detailed in Chapter 4 Installation and Related Tasks MATRIXx version 7 x must be installed in a different installation directory if you plan to keep versions prior to 6 x The version 7 x installation will not affect an older version of MATRIXx software as long as you do not use the same parent directory You do not have to do any extra work to keep the older version of MATRIXx which will still use its own license manager You can install a copy of MATRIXx on a local node usi
43. n matches the host ID specified in the license file on the server line for the vendor or on the feature line for a node locked client You can run the 1mhost id program to see what FLEXIm thinks the host ID is You cannot modify the host ID in the license file If the host ID of your server machine changes you will have to get a new license file from your software vendor 5 10 ni com Chapter 5 FLEXIm Licensing Tools Connection Problems symptom The application program or 1mstat cannot connect to the server to check out a license cause The FLEXIm routines in the application are unable to make a TCP connection to the server and port specified in the license file Possible reasons for this are 1 The wrong license file is being referenced by the application program 2 The server machine specified in the license file is down The vendor daemon specified in the license file is not running 4 The hostname in the license file is not recognized by the system 5 The network between the client machine and the server machine is down 6 TCP is not running on your machine solution Verify that the application is using the proper license file Verify that the specified server machine is up and reachable by executing another command that uses TCP such as rsh or rlogin from the client to the server Verify that the vendor daemon is running you can use the ps command on the server to look for it Examine the license log fil
44. ng either floating or node locked licensing or you can use a file server a shareable disk and a shared license manager to install the MATRIXx software on a network server The directory structure detailed here is of interest in both situations as it handles multiple versions and multiple platforms Directory Structure The directory structure shown in Figure 2 1 shows the MATRIXx product structure which enables you to manage the software in a central location in a network environment This structure reduces the system administration issues of multiple installations for a given platform because installation can be completed solely on a file server using a common license manager Then a simple client installation on a networked node will let you access the file server installation You can safely install multiple versions of MATRIXx version 7 x into a common root installation directory SMTXHOMES National Instruments Corporation 2 1 MATRIXx System Administrator Guide Windows Chapter 2 Software Structure ER Note All machines that will use MATRIXx software must be able to access the SMTXHOMES root directory MIXHOMES and installation directory referred to elsewhere in this document are equivalent The commands used to invoke the MATRIXx suite of products can be found in the 3MTXHOME bin directory MTXHOME bin NILM mx_version see note below altia MATRIXX config
45. nononncnancnnonnncnncnnncnncnanonccnnconos 3 1 Redundant License Servers eese neret 3 1 Flexible License CheckoUt rct eti re eret eei e REN 3 2 National Instruments Corporation V MATRIXx System Administrator Guide Windows Contents Xmath Licensing Commands essere rennen remettre 3 3 LICENSECHECK OUD ttti tette tre ER E epe 3 3 EICENSEUSER 4 tr eb E eines ie Basti ae te ee 3 3 LICENSEINEO 2 5 n te ei s 3 5 LICENSEFILE ette e e eere eerte e EHE Rd 3 5 NIRBENUM 55a rsen meteo tiit eme DR REED 3 5 Using Licensing eee band suey pira 3 6 License File oen tH ted mega 3 6 Proxy License Files iet eed d e ep e ee ele e EE HERMES 3 8 Compatibility e rto eee gute ipe RO 3 8 Licensing Requirements 2 netter rette e dove sacs a e Ye He exe Pe oed 3 9 Finding the Host TD cunoticias ENE a ees 3 9 Finding the Computer Name essere enne 3 10 Contacting National Instruments sees 3 10 Chapter 4 Installation and Related Tasks Version 7x Installation iir detecto bre tee Hp Hee Eee ele Ern barra 4 1 R quirements x anb Ene tag ree ets 4 1 Installation Procedure its onem er ainda 4 1 License Installation iii da td iia aia 4 4 Installing Other Components eese eene rennen 4 6 Installing Altia Design Animation eene eee 4 6 Instalhng Altia FacePlate trt ttes 4 7 In
46. nts e Chapter 2 Software Structure describes the MATRIXx Product Family directory structure and planning options Chapter 3 Licensing and Terminology describes licensing related terminology and tasks e Chapter 4 Installation and Related Tasks gives a detailed explanation of the version 7 x installation procedure and related tasks e Chapter 5 FLEXIm Licensing Tools discusses the version 7 x license manager utilities license manager debugging and daemon log file bold italic The following conventions appear in this manual The symbol leads you through nested menu items and dialog box options to a final action The sequence File Page Setup Options directs you to pull down the File menu select the Page Setup item and select Options from the last dialog box This icon denotes a note which alerts you to important information This icon denotes a caution which advises you of precautions to take to avoid injury data loss or a system crash Bold text denotes items that you must select or click in the software such as menu items and dialog box options Bold text also denotes parameter names Italic text denotes variables emphasis a cross reference or an introduction to a key concept This font also denotes text that is a placeholder for a word or value that you must supply National Instruments Corporation ix MATRIXx System Administrator Guide Windows About This Manual monospace mon
47. ny damages arising out of or related to this document or the information contained in it EXCEPT AS SPECIFIED HEREIN NATIONAL INSTRUMENTS MAKES NO WARRANTIES EXPRESS OR IMPLIED AND SPECIFICALLY DISCLAIMS ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE CUSTOMER S RIGHT TO RECOVER DAMAGES CAUSED BY FAULT OR NEGLIGENCE ON THE PART OF NATIONAL INSTRUMENTS SHALL BE LIMITED TO THE AMOUNT THERETOFORE PAID BY THE CUSTOMER NATIONAL INSTRUMENTS WILL NOT BE LIABLE FOR DAMAGES RESULTING FROM LOSS OF DATA PROFITS USE OF PRODUCTS OR INCIDENTAL OR CONSEQUENTIAL DAMAGES EVEN IF ADVISED OF THE POSSIBILITY THEREOF This limitation of the liability of National Instruments will apply regardless of the form of action whether in contract or tort including negligence Any action against National Instruments must be brought within one year after the cause of action accrues National Instruments shall not be liable for any delay in performance due to causes beyond its reasonable control The warranty provided herein does not cover damages defects malfunctions or service failures caused by owner s failure to follow the National Instruments installation operation or maintenance instructions owner s modification of the product owner s abuse misuse or negligent acts and power failure or surges fire flood accident actions of third parties or other events outside reasonable control Copyright Under the copyright laws this publication may not be
48. o c YProgram Files National Instruments MATRIXx but you can use the Browse button to select any other local or server location 5 After you click Next the Setup Type dialog box prompts you to select Client Server or Standard the default Select the appropriate type as described in the Installation Configurations section of Chapter 1 Installation and Related Tasks MATRIXx System Administrator Guide Windows 4 2 ni com Chapter 4 Installation and Related Tasks Setup Type x Click the type of Setup you prefer then click Next Client Server Description This will install the MATRIX software components on this machine NATIONAL INSTRUMENTS Set a If you select Client you will be prompted for the path to an existing MATRIXx server installation Choose MATRIXx Server Installation x Please enter the location of the existing MATRIX 63 b1 server installation National Instruments recommends a network pathname in the form servername sharename Browse NATIONAL ENS TRUMENTS lt Back Cancel b Ifyou select Server you will be prompted for the Sharename for the installation directory unless you entered a universal naming convention UNC pathname as the install location O National Instruments Corporation 4 3 MATRIXx System Administrator Guide Windows Chapter 4 Installation and Related Tasks Choose MATRIXx Sharename i xj Please enter a sharename fo
49. options file file The options file specified in the license file could not be opened license daemon lost all connections This message is logged when all the connections to a daemon are lost which often indicates a network problem lost lock exiting Error closing lock file Unable to re open lock file The vendor daemon has a problem with its lock file usually because of an attempt to run more than one copy of the daemon on a single node Locate the other daemon that is running via a ps command and kill it with kill 9 NO DAEMON line for daemon The license file does not contain a DAEMON line for daemon No license service found The TCP license service did not exist No license data for feat feature unsupported There is no feature line for feat in the license file No features to serve A vendor daemon found no features to serve This could be caused by bad data in the license file UNSUPPORTED FEATURE request featureby user The user has requested a feature that this vendor daemon does not support This can happen for a number of reasons the license file is bad the feature has expired or the daemon is accessing the wrong license file Unknown host hostname The hostname specified on a SERVER line in the license file does not exist in the network database MATRIXx System Administrator Guide Windows 5 16 ni com Chapter 5 FL
50. ospace bold monospace italic Platform Text in this font denotes text or characters that you should enter from the keyboard sections of code programming examples and syntax examples This font is also used for the proper names of disk drives paths directories programs subprograms subroutines device names functions operations variables filenames and extensions Bold text in this font denotes the messages and responses that the computer automatically prints to the screen This font also emphasizes lines of code that are different from the other examples Italic text in this font denotes text that is a placeholder for a word or value that you must supply Text in this font denotes a specific platform and indicates that the text following it applies only to that platform Format Conventions Code Examples or Program Output This manual uses a special formatting convention to present code examples or screen output from the installation program The example format has a numbered heading followed by a line the end of the example is also followed by a line Symbol Conventions Environment Variables This manual uses the character to denote environment variables For example SystemRoot 1system321driverstetcYhosts is not an absolute path because it depends on the definition of SystemRoot The most commonly used environment variable in this document is SMTXHOMES which is used to refer to the MATRIXx Product Family in
51. our own C code to Xmath or SystemBuild you must purchase and install a copy of Microsoft Visual C or 6 0 For FORTRAN you must install a copy of DIGITAL Visual Fortran 5 0 or 6 0 B Note DIGITAL Visual Fortran 5 0 for Windows NT releases 408 through 333E requires a patch for the linker before it will work properly Contact Digital at www digital com fortran to acquire the patch e Floating licenses require properly functioning TCP IP networking which includes Winsock 1 1 or later e Internet Explorer 5 or later is required for MATRIXx Help MATRIXx System Administrator Guide Windows 1 2 ni com Chapter 1 Installation Overview and Platform Requirements Compatible Compilers and Operating System Versions AN The MATRIX x version 7 x software was developed and tested with the operating system versions and compiler versions listed in Table 1 2 These configurations are recommended for optimal compatibility Other operating system versions and compiler versions may be compatible with the MATRIXx version 7 x software please check the National Instruments Support page at ni com support or contact Technical Support at supporteni com or 877 493 2404 Table 1 2 Verified Compilers Compiler Windows 2000 Windows NT 4 0 or Windows XP C or C Microsoft Visual C C version 6 0 FORTRAN DIGITAL Visual Fortran version 6 0 Caution Other compilers may work in certain cases but they are not supported
52. r the MATRIX installation directory Sharename MATRIX NATIONAL ON NSrRUMENTS lt Back Cancel 6 Setup copies the MATRIXx product files updates any shared components and launches the license manager installation License Installation 7 The License Manager NILM installation asks you whether you want to generate a new license file License dat Generate License File 2 Do you need to generate a new license dat file If you have an existing license file a copy will be saved as license dat old o 3 Note Ifyou don t already have a version 7 x license file click Yes to generate one If you intend to access a floating license provided by another host click No to avoid generating a new license Then when the installation is complete use a text editor to create a proxy license file named 1icense datinthe installation directoryNNILM folder as described in the Proxy License Files section of Chapter 3 Licensing and Terminology MATRIXx System Administrator Guide Windows 4 4 ni com Chapter 4 Installation and Related Tasks a If you click No go to step 8 b If you click Yes the installation prompts you for your reference number authorization key and checksum License Information x Please enter the following license key information To exit without generating a license file leave all fields blank and click Next RefNum AuthKey Checksum NATIONAL OANSTRU
53. s to N licenses of feature EXITING DUE TO SIGNAL nnn EXITING with code nnn All daemons list the reason that the daemon has exited EXPIRED feature feature has passed its expiration date MATRIXx System Administrator Guide Windows 5 14 ni com Chapter 5 FLEXIm Licensing Tools IN feature by user N licenses user has checked back in N licenses of feature License Manager server started The license daemon was started Lost connection to host A daemon can no longer communicate with its peer on node host which can cause the clients to have to reconnect or cause the number of daemons to go below the minimum number in which case clients may start exiting If the license daemons lose the connection to the master they will kill all the vendor daemons vendor daemons will shut themselves down Lost quorum The daemon lost quorum so it will only process connection requests from other daemons MULTIPLE xxx servers running Please kill and restart license daemon The license daemon has detected that multiple copies of vendor daemon xxx are running The user should kill all xxx daemon processes and restart the license daemon OUT feature by user N licenses user has checked out N licenses of feature RESERVE feature for HOST name RESERVE feature for USER name A license of eature is reserved for either user name or host name
54. s your site has purchased or to view the license expiration date use the command LICENSEINFO e Tosee who is using a given feature or to see if a feature is available use the LICENSEUSER command and specify the desired feature e To see the current license file search path use the command LICENSEFILE e Toreserve features for future use for example for a scheduled demo or presentation use the LICENSECHECKOUT feature The initial distribution of licenses is determined at the time of the installation to change licensing your system administrator must get a new key from National Instruments To generate a new license file from this key run the standalone license installation as described in the Updating a License File section of Chapter 4 Installation and Related Tasks National Instruments uses the FLEXIm license manager a product of Macrovision Corporation If you have license manager questions beyond the scope of this document refer to the FLEXIm End User Manual on the MATRIXx Bookshelf For additional information about FLEXIm refer to the the Macrovision FAQ at www macrovision com solutions esd support lmwinfaq htm License Files The set of licensed features available for checkout by a MATRIXx user are contained in one or more license files each containing encrypted feature lines The following default license files are used by the MATRIXx products MTXHOME NILM 1
55. servers NI issues redundant license server keys once you provide the hostid of the three servers At a minimum you need to run the standalone license server installation program and start the license server on each machine Follow the instructions described in the Installing Redundant License Servers section of Chapter 4 Installation and Related Tasks Figure 3 1 shows a typical redundant license server configuration MTXHOME MTXHOME license dat Y gt license dat Windows Server SIHOME license dat Windows Server One or More Client or Standalone Systems Figure 3 1 Typical Redundant License Server Configuration Flexible License Checkout With MATRIXx version 7 x licensing a feature product component is checked out as you use it A feature stays checked out until you exit that product component For example Xmath and SystemBuild modules are checked out when first used and stay checked out until you exit Xmath or SystemBuild SystemBuild is checked out when you launch the Catalog Browser by starting SystemBuild and stays checked out until you exit SystemBuild The flexible license checkout feature is also known as on demand checkout MATRIXx System Administrator Guide Windows 3 2 ni com Chapter 3 Licensing and Terminology Xmath Licensing Commands Xmath has the following license related commands ICENSECHECKOUT for checking out
56. stallation directory MATRIXx System Administrator Guide Windows X ni com About This Manual Related Publications National Instruments provides a library of publications to support its products Of special interest to the users of this publication are the installation guides summarized as follows e MATRIXx Product Family CD and booklet Installation Guide Windows e FLEXIm End User Manual from Macrovision Corporation e For additional documentation refer to the MATRIXx Help or the National Instruments Web site at ni com matrixx O National Instruments Corporation Xi MATRIXx System Administrator Guide Windows Installation Overview and Platform Requirements This chapter provides an overview of hardware and software requirements for MATRIXx version 7 x Installation Overview MATRIX x version 7 x includes installation software that performs a complete installation for the product This includes three setup types as described in Table 1 1 Table 1 1 Setup Types Type Description Client Installs client software only Server Windows 2000 NT XP Installs the product software on a network server Standard Installs the product software on a local PC iyi Note The Server and Standard installation processes require approximately 135 MB of disk space during the installation process The product software requires approximately 24 to 48 MB of RAM The installation software incl
57. stalling the Standalone License Manager eene 4 7 Installation Procedure se cs 2er re erre pes 4 8 Installing Redundant License Servers eene 4 8 Updating a License Pileta Om RS 4 9 Using Online Help 2e eene nnde edad 4 9 Printing Files ett ertet n eee 4 0 Installation Related Tasks d RU eR tete eoe Rs 4 0 Setting Up a User Environment for Printing esse 4 9 Running Multiple MATRIXx Versions eeeeeeeeeeeeene eee 4 10 Recording Your Reference Number eee 4 10 Moving the MTXHOME Directory Tree to Another Directory 4 10 Configuration Management Tasks esee 4 10 Troubleshooting Your Installation o oonnnnnnnccnncononcconccnonaconcconrnconcconnnconccnnnos 4 11 Virus Scanners and Utility Software sess 4 11 Temp Directory Usage During Install ees 4 12 License SOLVEIS iecit A 4 12 Uninstallins Version 7X nette pe init 4 13 MATRIXx System Administrator Guide Windows vi ni com Contents Chapter 5 FLEXIm Licensing Tools ELEXIM Utes evitan 5 1 Mr ect id di e ome mee E 5 1 Istat siia etu adeo ep d eee 5 2 Itireread incer ettet e ont ven e ie Po eerte d tiep 5 3 Imhostide sette eee US 5 3 Md qae te n eg dove ati t E Oe Rn 5 4 Imvet ausente a eaaet quss 5 4 lioe e 5 4 Initiating Borrowing
58. stion receives an answer Training and Certification Visit ni com training for self paced training eLearning virtual classrooms interactive CDs and Certification program information You also can register for instructor led hands on courses at locations around the world System Integration If you have time constraints limited in house technical resources or other project challenges NI Alliance Program members can help To learn more call your local NI office or visit ni com alliance If you searched ni com and could not find the answers you need contact your local office or NI corporate headquarters Phone numbers for our worldwide offices are listed at the front of this manual You also can visit the Worldwide Offices section of ni com niglobal to access the branch office Web sites which provide up to date contact information support phone numbers email addresses and current events O National Instruments Corporation A 1 MATRIXx System Administrator Guide Windows
59. t is used to perform the following Initiating borrowing by setting the borrow period e Clearing the borrow period MATRIXx System Administrator Guide Windows 5 4 ni com Chapter 5 FLEXIm Licensing Tools e Determining borrow status e Returning a borrowed license early Initiating Borrowing To initiate borrowing the user sets the borrow period by running lmborrow from the command line or through LMTOOLS lmborrow vendor all enddate time where vendor The vendor daemon name that serves the licenses to be borrowed or a11 specifies all vendor daemons in that license server enddate time Date the license is to be returned in dd mmm yyyy format time is optional and is specified in 24 hour format hh mm in the FLEXIm licensed application s local time If time is unspecified the checkout lasts until the end of the given end date For example lmborrow sampled 20 aug 2001 13 00 Windows This has the effect of setting LM BORROW with the borrow period in either registry To borrow licenses for the desired vendor on the same day and the same machine that the user runs 1mborrow run the application s to check out the license s If you run the application s more than once that day no duplicate licenses are borrowed No licenses are borrowed if the application is run on a day different than the date borrowing is initiated In addition to the 1mborrow utility there are other ways to initiate borrowing
60. the utility you must install the CM license key FEATURE sysbldcm For MATRIXx System Administrator Guide Windows 4 10 ni com Chapter 4 Installation and Related Tasks information about obtaining and installing license features refer to Chapter 3 Licensing and Terminology The ClearCase Merant PVCS Perforce and Microsoft Visual SourceSafe CM tools all have their own native working enviroment that must be installed and functioning before the CM tool can be used with SystemBuild SystemBuild uses the Microsoft Common Source Code Control interface to connect with these tools When one of these CM tools 1s installed entries are written to the Windows registry These registry entries allow SystemBuild to connect to the CM tool When you connect to CM you must set your working directory to the working directory for the selected project The CM tool supports working with one project at a time there is a 1 1 relationship between the working directory and a project Troubleshooting Your Installation The following sections provide some troubleshooting tips Virus Scanners and Utility Software It is important that virus scanner software be disabled before installing MATRIXx Virus scanners and some utility software can interfere with the ability of the InstallShield program to run external programs during installation External programs are used during install to set the installation path in MATRIXx launching scripts and to generate t
61. udes the Flexible License Manager FLEXIm iyi Note MATRIXx can be installed on a file server using a shared license manager Platform Requirements National Instruments supports the MATRIXx version 7 x software in the hardware and software environments described in the following sections National Instruments Corporation 1 1 MATRIXx System Administrator Guide Windows Chapter 1 Installation Overview and Platform Requirements Hardware Requirements The following requirements apply to all computers that will run MATRIXx on Windows 2000 NT XP e Pentium III 500 MHz or equivalent Minimum 32 MB RAM 64 MB recommended e A video card that supports a minimum of 256 colors at 800 x 600 resolution 65 536 colors at 1024 x 768 resolution is recommended True Color setting 16 million is supported e A CD ROM drive e Approximately 135 MBs of disk space to complete a full MATRIXx installation Refer to Table 1 3 for details e A 2 button Microsoft compatible mouse with a 3 button Logitech mouse or equivalent preferred 3 Note You can change the number of colors for your display through Start Settings Control Panel Display Settings Software Requirements The following requirements apply to all computers that will run MATRIXx on Windows 2000 NT XP The MATRIXx software requires Windows 2000 Windows NT version 4 0 or Windows XP Supported installations include English Japanese and German e Ifyou want to link y
62. umber for drive C can be used A disk volume serial number is an 8 character string with the dash omitted Table 3 1 lists alternate methods to obtain the required host ID Table 3 1 Obtaining the Host ID Host ID DOS Shell Command Example Ethernet address ipconfig all 08002be5a721 Physical address Disk volume serial C 1F68 5D8A number for C drive vol disregard dash O National Instruments Corporation 3 9 MATRIXx System Administrator Guide Windows Chapter 3 Licensing and Terminology Finding the Computer Name The computer name is defined at the time Windows is installed To see the computer name select Start Settings Control Panel Network The Identification tab appears the first entry is the computer name Contacting National Instruments Contact NI in one of the following ways e Complete a Key Request Form included with your software and fax it to 512 683 9007 e Send email with the information asked for in the Key Request Form to matrixx ni com e Call 877 493 2404 between 7 a m and 7 p m Central Time Monday through Friday to speak with a MATRIXx representative to assit you with obtaining your license key NI supplies the authorization key s and checksum s used to generate the license file which enables you to use the packages and modules you purchased An authorization key or checksum is an alphanumeric string that does not contain the numbers 0 1 or 5 to avoid con
63. vendor daemon this message is output to the log file This error is typically caused by one of the following 1 There is no executable at the location referred to by the license file and printed out in the log file 2 Theexecutable does not have the proper protection to be run the file does not have the x bit set or one of the directories in the path is not readable 3 There was an error building the executable and it cannot be run 4 The executable is for a different machine architecture Verify that the path to the vendor daemon is absolute and that it points to the executable program itself not the containing directory for FLEXIm v1 5 Ensure that the file exists by doing an 1s 1 of the vendor daemon filename s specified in the log file Make sure you do this as the same user that started 1mgra Verify that the file is executable Run the vendor daemon directly from the command line If the vendor daemon is properly linked it will tell you that it must be run from 1mgrd if it crashes or fails to execute then it is not properly linked The license server keeps reporting lost lock errors in the log file and exiting The lockfile is being removed by someone else There could be another daemon running or the system administrator or a script could have deleted the file 5 13 MATRIXx System Administrator Guide Windows Chapter 5 FLEXIm Licensing Tools solution Daemon Log File Check to see 1f there is
64. x software must be installed in a different directory MTXHOMES directory than MATRIXx 5 x MATRIXx System Administrator Guide Windows 3 8 ni com Chapter 3 Licensing and Terminology versions of the MATRIXx license manager for MATRIXx 5 x do not have to be stopped to install the new software MATRIXx 6 x ISILM and MATRIXx 7 x NILM can share the same 7 MTXHOME directory since their license directories are different You would only need to kill the older license manager daemon 1mgra if you choose to reove the old software Because of the addition of new features and new license manager functionality license keys issued prior to MATRIXx 7 x cannot be used to regenerate a license file for version 7 x Licensing Requirements In order to obtain a license you must provide the computername and hostia for each license server machine Finding the Host ID FLEXIm uses different machine identifications for different machine architectures An Ethernet address is the preferred host ID for a Windows platform An Ethernet address is a 6 byte quantity with each byte specified as two hexadecimal digits Specify all 12 hex digits when using an Ethernet address as a host ID The program MTXHOME NNILMN1mhostid will print the Ethernet host ID that FLEXIm expects to use on any given machine For floating licenses you must provide an Ethernet address For node locked licenses an Ethernet address is preferred but a disk volume serial n
65. ying the cause as described in Table 4 1 MATRIXx System Administrator Guide Windows 4 12 ni com Chapter 4 Installation and Related Tasks Table 4 1 Error Message Definitions Command Error Message or Problem Cause or Remedy Imdiag 1mdi ag reports that the Kill all Imgra processes hostid is correct but the started for the license daemon has not been license dat file they started are trying to use the same TCP IP port and start a new lmgrd process lmreread c license file You cannot use lmreread You have changed the to change server node names server name or port or port numbers number Kill the old daemon then restart the license daemon Uninstalling Version 7 x O National Instruments Corporation The following summarizes the items to consider when performing a complete uninstall of MATRIXx software All MATRIXx and Altia software should be removed by using the Add Remove Programs applet in the System Control Panel If you want to uninstall the optional Altia Design software and it is installed under the MATRIXx installation directory then NI recommends that you uninstall it before removing MATRIXx Windows 2000 NT XP If you want to uninstall the MATRIXx License Server then NI recommends that you uninstall it before removing MATRIXx Windows NT If you want to uninstall a server installation of the MATRIXx version 7 x software you should first remove any file shares associated wit

Download Pdf Manuals

Related Search

Related Contents

  PayPal Express Checkout - 2009 Integration Guide  INSTRUCTION MANUAL    Mobile Device Standards & Guidelines  Hunter 45190 User's Manual  Panasonic H-H014 camera lense  Carte Culture MGEN 87  Illumine CLI-ONF120ORB Use and Care Manual  GUIDE DE L`UTILISATEUR  

Copyright © All rights reserved. Failed to retrieve file