IRIS Explorer, Release 5.0 IENTI50NA Windows NT/2000 Installer's Note Contents 1. General Information 1.1. Introduction 1.2. Applicability 1.3. Distribution Medium 1.4. IRIS Explorer System 1.5. Disk Space Requirements 2. Installation 2.1. Installation Method 2.2. Machine Configuration 2.3. Quick Test 3. Further Information 3.1. Online Documentation 3.2. Configuration Settings 3.3. Running Modules over a Network 3.4. Known Problems with this Release 4. Support from NAG 5. User Feedback Appendix A - License Management 1. General Information 1.1. Introduction This document is essential reading for the NAG Site Contact responsible for installation and maintenance of the IRIS Explorer implementation specified in the title. The installer will be provided with a printed copy of this document (Installer's Note). The use of all supplied software must be in accordance with the terms and conditions of the Software Licence signed by NAG and each site. Any request to use NAG software on a computer other than the one licensed must be referred to NAG (see Section 4). 1.2. Applicability The Windows NT/2000 version of IRIS Explorer is considered suitable for operation on the computer systems detailed below: hardware: Intel-based PC. A clock speed of 120 MHz or above is recommended (preferably a Pentium-type chip) with at least 32 Mb RAM (64 Mb recommended) system software: Windows NT 4.0 or Windows 2000. An HTML browser such as Netscape Navigator or Microsoft Internet Explorer is required to view the IRIS Explorer online hypertext documentation graphical devices: To obtain the best graphics performance it is recommended that a graphics card is installed for OpenGL acceleration. Some information on OpenGL cards and their performance may be obtained from http://www.opengl.org/ 1.3. Distribution Medium IRIS Explorer is distributed on CD-ROM (please contact NAG if you require alternative installation media). Most files on CD-ROM are in a compressed format, suitable for the installation program supplied. The files must be installed on a hard disk in a number of directories forming a simple tree beneath a named directory of your choice. 1.4. IRIS Explorer System The IRIS Explorer distribution includes the following: Main IRIS Explorer System IRIS Explorer Map Editor, run-time DLLs and associated controllers. This is the basic execution environment for IRIS Explorer. IRIS Explorer Modules IRIS Explorer module executables and help pages. This release includes 290 modules. See also Unsupported Modules. Demonstration Maps This release contains 164 maps and 5 applications demonstrating the use of many of the supplied modules. IRIS Explorer Data IRIS Explorer sample data files. These are needed to run the examples in Chapter 1 of the IRIS Explorer User's Guide and the demonstration maps. In addition, several other datasets are included for your use. Unsupported Modules IRIS Explorer module executables and help pages contributed by users. These modules are provided "as-is" without support from NAG. This release includes 80 such modules. License System IRIS Explorer license management daemons and associated files. IRIS Explorer Documents An introductory tutorial, plus a four volume manual set (IRIS Explorer User's Guide, Reference Pages, Module Writer's Guide, Collaborative User's Guide) as well as newsletters, user stories and example images in online hypertext format. Plus the IRIS Explorer Release Notes and Installer's Note. Module Builder Tool to help users create their own IRIS Explorer modules. 1.5. Disk Space Requirements The file sizes are given below. The actual disk space used is dependent on the hard disk allocation unit (cluster) size (this information is supplied by the DOS command CHKDSK). (Mbytes) Main System + modules 120.1 Module source 19.9 Unsupported modules 12.5 License materials 18.1 On-line documentation 14.5 ----- Total 185.1 2. Installation 2.1. Installation Method To install IRIS Explorer on your machine, you must have Administrator privileges; installation by an ordinary user will fail, as such users cannot create the system-wide environment variables required by the IRIS Explorer program. The CD should autorun on Windows NT 4.0 or Windows 2000 systems, and will then lead you to a dialogue for installation. If this does not operate, then double click on the setup.exe file on the CD using Windows Explorer. Any continuing difficulties indicate a problem which should be reported to the NAG Response Centre (see Section 4). The installation program will suggest a default location for IRIS Explorer, c:\EXPLORER50. This can be changed if a different drive and directory is required. If you choose "custom" installation, you will then be asked which IRIS Explorer components you wish to install. You have the choice of the main IRIS Explorer files, the on-line documentation, the module source files, the unsupported modules and the FLEXlm license materials (see Appendix A). In the remainder of this document, and in the IRIS Explorer documentation, the symbol EXPLORERHOME is used to stand for the root of the IRIS Explorer installation. This symbol is used internally by IRIS Explorer, but it is no longer necessary for the installation procedure to set its value (unlike previous versions of IRIS Explorer). The installation program will suggest a name for the IRIS Explorer program folder, IRIS Explorer 5.0, which can be changed if desired. The following icons will be created in the requested folder: - Collaborative Visualization sub-folder: - COVISA Server Help : Help for the IRIS Explorer collaborative functionality - COVISA Server Pass : Server required by collaborative sessions of IRIS Explorer and its applications, running in Pass mode - COVISA Server SAF : Server required by collaborative sessions of IRIS Explorer and its applications, running in Store and Forward mode - Graph Viewer Application : Application to view graphs, demonstrating how collaborative applications may be used - Medical(blood) Application : Medical application which may be used stand-alone or with the Collaborative Medical (bone) Application to show the power of collaborative applications - Medical(bone) Application : Medical application which may be used stand-alone or with the Collaborative Medical (blood) Application to show the power of collaborative applications - PDBViewer Application : Collaborative version of the PDBViewer Application - Documentation sub-folder: - Installer's Note : This document - Online Documentation : Root of the online documentation. Please refer to Section 3.1 - Release Notes : A document giving information about this release of IRIS Explorer, including its new features - Examples sub-folder: - FAQ & Interactive Demos : List of Frequently Asked Questions about IRIS Explorer, together with interactive demos which illustrate how to perform some common tasks - PDBViewer Application : Demonstrating the use of an IRIS Explorer application to view chemistry (PDB) data - Tools sub-folder: - QuickLat : Runs the QuickLat application, which aids input of lattice data - Remote Server : Runs the cxRshd remote shell daemon. Please refer to Section 3.3 - IRIS Explorer : Runs IRIS Explorer - IRIS Explorer Install Test : Runs IRIS Explorer with a simple map to test the installation - Module Builder : Runs the Module Builder application to help create new IRIS Explorer modules You can run IRIS Explorer only when you have also installed a FLEXlm license for the product. This can be done by following the instructions given in Appendix A. The "Install IRIS Explorer license" dialog box pops up automatically when IRIS Explorer is started if a correct license is not detected. Changes to the license can also be made from within IRIS Explorer (from the License option on the Configuration menu). For more information on license types and license information you are referred to Appendix A of this document. 2.2. Machine configuration At Release 5.0 of IRIS Explorer, it is no longer necessary to have TCP/IP installed unless you are going to run modules remotely. See Section 3.3 for details. 2.3. Quick Test You can test the basic functionality by double clicking on the "IRIS Explorer Install Test" icon in the IRIS Explorer program folder. This draws a simple 3D model which you can rotate with the mouse. You can also try any other maps from the Module Librarian. 3. Further Information 3.1. Online Documentation A full set of documentation in online hypertext format is provided with this release of IRIS Explorer. The root of the online distribution is at %EXPLORERHOME%\docs\html\index.htm which is accessible in the IRIS Explorer program folder, Documentation sub-folder, as the "Online Documentation" icon. The documentation can be viewed by any suitable HTML browser such as Netscape Navigator or Microsoft Internet Explorer. Double clicking on the icon starts the browser which has been associated with HTML files and loads the file into the browser. Alternatively, the documentation is also accessible from the Help menu on the IRIS Explorer Map Editor, or from the Help menu on the IRIS Explorer Module Builder. The documentation set comprises an introductory tutorial, plus a four volume manual set for the system: IRIS Explorer User's Guide IRIS Explorer Reference Pages IRIS Explorer Module Writer's Guide IRIS Explorer Collaborative User's Guide as well as newsletters, user stories and example images. The documentation also contains external links to IRIS Explorer sites on the WWW; use of these requires your machine to be connected to the Internet. 3.2. Configuration Settings The file %EXPLORERHOME%\Explorer.config contains configuration information for IRIS Explorer and is read the first time IRIS Explorer starts up. It contains the default locations of modules and maps, establishes module categories, and sets the shared memory arena size. This file is global to the host machine. Configuration requirements that are private to a user are stored in the registry under that user's key. Configuration settings can be changed via the options on the Configuration menu in the IRIS Explorer Map Editor. The settings stored in the registry are automatically updated. More information on configuration settings is contained in Appendix A of the IRIS Explorer User's Guide. 3.3. Running Modules over a Network It is possible to distribute an IRIS Explorer application across a heterogenous network, with modules running on a variety of workstations and PCs. The network utility, which can be started from the Windows NT/2000 control panel, allows you to configure TCP/IP for your particular network card. At this configuration stage, you can also decide whether or not to use DNS (the Domain Name System). Usually you will use DNS if you are using TCP/IP to communicate over the Internet or if your internal network uses DNS to distribute host information. The alternative to using DNS is to use the simpler method of storing names and addresses in the LMHOSTS (or HOSTS) file; typically under Windows NT/2000 this would be in the file \WINNT\SYSTEM32\DRIVERS\ETC\HOSTS. If you are running on a machine which is networked, you must ensure the following: - Driver software is installed for your network adapter card (use the "Add Adapter..." button of the control panel network utility to add a network adapter card). - TCP/IP MUST be installed (use the "Add Software..." button of the control panel network utility to install "TCP/IP Protocol"). - Once TCP/IP has been installed it MUST also be configured (use the "Configure..." button of the control panel network utility when "TCP/IP Protocol" is highlighted in the list of "Installed Network Software"). The IP Address must be provided at this step. - If the machine has a "domain name" specified in the "DNS Configuration" section of the "TCP/IP Configuration" menu, then either the LMHOSTS file or the DNS server MUST contain the fully qualified domain name (FQDN) of the local machine, associated with the local machine's IP address; for example if your machine is named "daisy", is part of a domain named "acme.co.uk", and has IP address 192.123.231.213, then a line like 192.123.231.213 daisy daisy.acme.co.uk should be present in the LMHOSTS file (or the DNS server database) to enable correct name/address resolution. When the machine has been correctly configured as described and the license management software is running (see Appendix A), you can try running IRIS Explorer as described in Section 2.3. For further details, please refer to Appendix A of the IRIS Explorer User's Guide. 3.4. Known Problems with this Release The group compilation process has been tested extensively and has been found to work with several groups of modules, but it cannot be guaranteed to behave correctly with every combination of modules. In particular, problems may occur for groups that include multiple instances of modules which are statically linked to libraries containing global or static data. Examples of these types of modules include those that use the NAG Graphics Library, LatFunction-based modules and ImageVision modules on some platforms. 4. Support from NAG (a) Contact with NAG Queries concerning this document or the implementation generally should be directed initially to your local Advisory Service. If you have difficulty in making contact locally, you can contact NAG directly at one of the addresses given in the Appendix. Users subscribing to the support service are encouraged to contact the IRIS Explorer Centers (see below). The NAG Response Centres are available for general enquiries from all users. (b) IRIS Explorer Centers The IRIS Explorer Centers are available for technical queries from sites with an annually licensed product or support service. The IRIS Explorer Centers are open during office hours, but contact is possible by fax, email and phone (answering machine) at all times. When contacting the IRIS Explorer Centers please quote your NAG site reference and NAG product code (in this case IENTI50NA) The locations are: IRIS Explorer Center (Europe) Wilkinson House Jordan Hill Road OXFORD OX2 8DR United Kingdom Tel: +44 (0)1865 516377 Fax: +44 (0)1865 516388 email: support@nag.co.uk WWW: http://www.nag.co.uk/Welcome_IEC.html IRIS Explorer Center (North America) 1400 Opus Place, Suite 200 Downers Grove IL 60515-5702 USA Tel: +1 630 971 2367 Fax: +1 630 971 2346 email: explorer@nag.com WWW: http://www.nag.com/ IRIS Explorer Center Japan (IECJ) Yaesu Nagaoka Building No. 6 1-9-8 Minato Chuo-ku Tokyo Japan Tel: +81 (0)3 5542 6311 Fax: +81 (0)3 5542 6312 email: help@nag-j.co.jp WWW: http://www.nag-j.co.jp/ (c) NAG Websites The NAG websites are an information service providing items of interest to users and prospective users of NAG products and services. The information is reviewed and updated regularly and includes implementation availability, descriptions of products, downloadable software, product documentation and technical reports. The NAG websites can be accessed at http://www.nag.co.uk/ or http://www.nag.com/ (in North America) or http://www.nag-j.co.jp/ (in Japan) (d) NAG Electronic Newsletter If you would like to be kept up to date with news from NAG you may want to register to receive our electronic newsletter, which will alert you to special offers, announcements about new products or product/service enhancements, case studies and NAG's event diary. To register visit one of our websites or contact us at nagnews@nag.co.uk. 5. User Feedback Many factors influence the way NAG's products and services evolve and your ideas are invaluable in helping us to ensure that we meet your needs. If you would like to contribute to this process we would be pleased to receive your comments by email at feedback@nag.co.uk. Alternatively contact the appropriate NAG Response Centre who will be happy to record your comments. Appendix A - License Management 1. Introduction The use of IRIS Explorer is controlled by the FLEXlm network license management system (FLEXlm is a registered trademark of Globetrotter Software Inc.). As with other products that use FLEXlm some or all of the FLEXlm license management system software needs to be installed on your system before you can run IRIS Explorer. The installation requirements of FLEXlm depend on the type of license you have negotiated with NAG. If you have a counted license (suitable for a network of machines) you are advised to have it installed by your system administrator. Section 2 of this appendix provides information on the available license types and points to consider in choosing a license suitable for your circumstances. Section 3 describes how to obtain and install uncounted licenses. Section 4 describes how to obtain and install counted licenses. Throughout this appendix it is assumed that IRIS Explorer will be the only software that uses FLEXlm on your system. If you already have other FLEXlm licensed software running you will need to consult FLEXlm documentation in order to install FLEXlm in the way that is most suitable for your circumstances. In particular, you are advised to read Chapter 3 of the FLEXlm End User Manual and questions 4.3, 4.4 and 4.5 of the FLEXlm FAQ; both are supplied (in html format) with this product; after installation they may be found in %EXPLORERHOME%\license\htmlman\flexuser and %EXPLORERHOME%\license\htmlman\flexfaq where %EXPLORERHOME% is the root directory of IRIS Explorer. Further information is available from Globetrotter Software at: Suite 131. 300 Orchard City Drive, Campbell, CA 95008, USA Phone: +1 408 370 2800 Fax: +1 408 370 2884 Email: info@globes.com http://www.globetrotter.com http://www.globetrotter.com/manual.htm - The FLEXlm End User Manual http://www.globetrotter.com/faq.htm - The FLEXlm FAQ Note: this release of IRIS Explorer uses version 7.0e of FLEXlm. 2. Choosing a License Two types of license are available; uncounted and counted licenses. Uncounted licenses which expire after a short period are issued to potential users of IRIS Explorer who wish to try out the product before buying it; these are sometimes called DEMONSTRATION or EVALUATION licenses. Uncounted licenses are also issued if you have bought IRIS Explorer or an application incorporating IRIS Explorer for use on a specific machine. These licenses are also called DEVELOPMENT or RUNTIME licenses, respectively. Counted licenses are suitable for networks of machines. Such networks may consist of machines which are all the same, or some machines may be different. A counted license allows you to to run a number of IRIS Explorer sessions concurrently on any computer on the network where IRIS Explorer was installed. As such a counted license is more flexible than an uncounted license. Counted licenses are sometimes referred to as NETWORK licenses. There are both DEVELOPMENT and RUNTIME licenses available for networks. Note: it is possible to have an uncounted license for a networked machine; this would not give you the same flexibility as a counted license as you would not be able to run IRIS Explorer on another machine on the same network. Nevertheless, this is a good option for evaluation purposes and if you are sure that you do not want to use IRIS Explorer on any other network machine. For uncounted licenses it is sufficient to install the license; no other licensing software is required and these licenses are therefore easy to install. Counted licenses also require the installation of the license daemon and the NAG daemon. In this case, when you start up IRIS Explorer a request is made to the license daemon which then requests an IRIS Explorer license from the NAG daemon. Depending on the license details and the number of IRIS Explorer applications you have already running on the network the request is granted or denied. Due to the complexity of the installation you are advised to have counted licenses installed by your system administrator. Only one license daemon and NAG daemon are required per network. They must both be installed on the same machine on the network. This machine is called the license server. You are free to select which machine on the network is to become the license server. You need to consider which machine is most suitable. It should be a machine that is always up and running when anyone on the network is likely to be running IRIS Explorer. It also needs to have an architecture and operating system that is supported by FLEXlm. At version 7.0e of FLEXlm it may be any of the following: DEC Alpha AXP Digital UNIX [Compaq Tru64 UNIX] Hewlett Packard 9000/700 series HP-UX Intel 80x86 Linux (RedHat 5 and equivalents) Intel 80x86 Linux (RedHat 4 and equivalents) Intel 80x86 Microsoft Windows (NT/2000 and 95/98) Intel 80x86 Linux (RedHat 6 and equivalents) IBM RISC System/6000 AIX Silicon Graphics IRIX version 5 Silicon Graphics (n32 ABI) IRIX version 6 Silicon Graphics (64-bit ABI) IRIX version 6 Sun 4 (SPARC) SunOS version 5 (Solaris) In summary, before installing FLEXlm you must decide the following: - Do you need a counted or an uncounted license? Uncounted licenses are for evaluation purposes or a specific machine and are easily installed by individual users. Counted licenses are for networks and should be installed by your system administrator. - If a counted or network license, which machine is to be the license server? Note 1: under Windows 95/98, unlike Windows NT/2000, it is not possible to install FLEXlm as a service. As such, if you wish to use a PC as the license server a Windows NT/2000 PC would be preferred. Note 2: although a Windows 95/98 machine may be used as the license server for a network, IRIS Explorer itself is not available on this platform. If you wish to install an uncounted license read Section 3; for counted licenses go to Section 4. 3. Uncounted Licenses 3.1. Obtaining an Uncounted License A uncounted license may be a simple time expiring or demonstration license or it may be bound to the PC through the hostid. If you have negotiated a time expiring demonstration license you will not need to supply the PC's hostid, and you may skip reading the remainder of this section. Other uncounted licenses are for stand-alone PCs. They are based on the volume serial number of the PC's Windows drive (where the Windows directory is installed); this will normally be the C drive. Type %EXPLORERHOME%\license\bin\i86_n3\lmtools in an MS-DOS window. A window will appear with a number of buttons; press the button called 'Hostid' and the volume serial number of the Windows drive will be displayed as the last item in the list (under the heading DISK_SERIAL_NUM=). Contact the NAG Response Centre and specify that you wish to obtain a stand-alone PC license for IRIS Explorer. If you require an evaluation license the volume serial number is not required. In the case of a development or runtime license you should quote the volume serial number which you just obtained. You will then receive your license information, usually via email or FAX. 3.2. Format of the Uncounted License File The information that you will receive from NAG contains a FEATURE line describing the product (or feature) being licensed; this line needs to be pasted into a license file. None of the keywords on the FEATURE line may be modified or the license will be invalid. However, when you extract the FEATURE line from an email message you should ensure that any newline characters that the email system may have inserted are removed. The format of the FEATURE line for an IRIS Explorer license is as follows: FEATURE name NAG 5.000 date lic key vendorstring [hostid] where name indicates the product that is being licensed; IRIS_Explorer for an evaluation or development license, IE_Runtime for a runtime license. NAG is the name of the NAG daemon, 5.000 is the latest version of IRIS Explorer supported, date is the expiry date (for example 06-aug-2001), lic is either 0 or 55, key is the license key, and vendorstring is a NAG-defined string in double quotes. If present, the hostid is the volume serial number of your PC (see Section 3.1). If the year is specified as 0 then the license will never expire. You may place the license file on your machine anywhere you like, but here it is assumed that the license file will be located at: C:\FLEXLM\NAGLM\LICENSE.DAT Note: FLEXlm uses a file called C:\FLEXLM\NAG to store information about the daemon; this means that you cannot use a directory called C:\FLEXLM\NAG in which to store your license file. 3.3. Installing the Uncounted License File Before you can run IRIS Explorer or an IRIS Explorer application on your PC you must install the license file. Set the environment variable LM_LICENSE_FILE to the full pathname of the license file on your PC. You may need to be Administrator to set this variable. Select "Settings" on the "Start" menu, and "Control Panel" on the submenu that appears. Then double click on the "System" icon to open up the "System Properties" window. Choose the "Environment" tab and a number of fields will appear. Point in the list "System Variables". This will highlight one of the lines in the "System Variables" window, and display the variable and its value in the two type-in slots at the bottom of the panel. Now type in the slot called "Variable" the word LM_LICENSE_FILE and in the slot called "Value" type the full pathname of the license file on your PC. Click on the "Set" button and you will see the new entry appear in the list of "System Variables" (they are listed in alphabetical order). Exit the menu by clicking on the "OK" button. Note: pointing to the list "User Variables for xxx" where xxx is the current user has the effect of making the environment variable available only to the current user; entering the environment variable in the "System Variables" window will make it a system wide resource. You can now run IRIS Explorer on your PC. 4. Counted Licenses 4.1. Obtaining a Counted License A counted or network license is based on the FLEXlm hostid of the license server. In order to obtain the FLEXlm hostid of your license server you need to use one of the FLEXlm utility programs provided with this product. After installation of IRIS Explorer the FLEXlm software is contained in the directory %EXPLORERHOME%\license\bin For FLEXlm version 7.0e this directory contains eleven subdirectories, each of which contains the FLEXlm software for a different platform: alpha_u3 - DEC Alpha AXP Digital UNIX [Compaq Tru64 UNIX] hp700_u9 - Hewlett Packard 9000/700 series HP-UX i86_g2 - Intel 80x86 Linux (RedHat 5 and equivalents) i86_l1 - Intel 80x86 Linux (RedHat 4 and equivalents) i86_n3 - Intel 80x86 Microsoft Windows (NT/2000 and 95/98) i86_r6 - Intel 80x86 Linux (RedHat 6 and equivalents) rs6000_u3 - IBM RISC System/6000 AIX sgi32_u5 - Silicon Graphics IRIX version 5 sgi32_u6 - Silicon Graphics (n32 ABI) IRIX version 6 sgi64_u6 - Silicon Graphics (64-bit ABI) IRIX version 6 sun_u5 - Sun 4 (SPARC) SunOS version 5 (Solaris) Depending on the architecture and operating system of the machine you have chosen as the license server you need to proceed as follows: a) The license server is the PC on which you just installed IRIS Explorer. As you have just installed IRIS Explorer on a PC this is perhaps the most likely situation. The FLEXlm software for Windows NT/2000 is in directory i86_n3. Execute the command %EXPLORERHOME%\license\bin\i86_n3\lmutil lmhostid to obtain the hostid of the license server. Note: you may like to copy the contents of subdirectory i86_n3 to a more convenient position on your PC such as C:\FLEXLM\NAGLM\BIN b) The license server is a PC but NOT the PC on which you just installed IRIS Explorer. Copy the contents of directory %EXPLORERHOME%\license\bin\i86_n3 over the network to the PC that is to become the license server. For example, you may copy the contents to a directory called C:\FLEXLM\NAGLM\BIN Execute the command lmutil lmhostid in the directory where you copied the contents to in order to obtain the hostid of the license server. c) The license server is not a PC Copy the contents of the relevant directory under %EXPLORERHOME%\license\bin over the network to the Unix machine that is to become the license server. For example, you may copy the contents to a directory called /usr/local/flexlm/nag/bin Execute the command lmutil lmhostid in the directory where you copied the contents to in order to obtain the hostid of the license server. You will normally also be asked for the hostname of the license server. This can be obtained by typing on your license server one of the following commands: ipconfig /all (Windows NT/2000) winipcfg /all (Windows 95/98) uname -n (Unix) Contact the NAG Response Centre quoting the hostid and the hostname of your license server and specify that you wish to obtain a network license for IRIS Explorer, and if the license is to be for development or runtime. You will receive your license, usually via email or FAX. Note: it is possible to specify the hostname information afterwards by editing the license information. However, it is easier if you are able to supply the correct name when you contact NAG. In this case, the hostname will be inserted in the license information you receive. 4.2. Format of the Counted License File The information that you will receive from NAG contains a FEATURE line describing the product (or feature) that is being licensed, and a SERVER and DAEMON line describing the license server and NAG daemon. These lines need to be pasted into a license file. Some of this information may need to be edited before the license will work correctly. The format of the FEATURE line for an IRIS Explorer license is as follows: FEATURE name NAG 5.000 date lic key vendorstring [hostid] where name indicates the product that is being licensed: IRIS_Explorer for a development license, IE_Runtime for a runtime license. NAG is the name of the NAG daemon, 5.000 is the latest version of IRIS Explorer supported, date is the expiry date (for example 06-aug-2001), lic is the number of concurrent IRIS Explorer sessions supported, key is the license key, and vendorstring is a NAG-defined string in double quotes. Sometimes an additional hostid is included, binding the license to a particular host or hosts. If the year in a FEATURE line is specified as 0 then the license will never expire. If present, the hostid is the string returned by the 'lmutil lmhostid' command (see Section 4.1). None of the keywords on the FEATURE line may be modified or the license will be invalid. However, when you extract the FEATURE line from an email message you should ensure that any newline characters that the email system may have inserted are removed. The format of the SERVER line for an IRIS Explorer license is as follows: SERVER hostname hostid 7312 where hostname and hostid are the hostname and hostid of the license server, and 7312 is the TCP/IP portnumber that is used by the license server for its communication with other machines on the network. The hostid is the string returned by the 'lmutil lmhostid' command (see Section 4.1). You may not change the string as this will invalidate the license. If you supplied the license server's hostname then this will appear after the word SERVER in the fax or email message. Otherwise the keyword will appear as 'hostname' and you should edit it now to be the hostname of your license server. You may also change the TCP/IP portnumber if that would better suit your circumstances. Valid numbers are unused numbers between 0 and 64000; if the network includes Unix machines numbers must be greater than 1024 as smaller numbers are privileged portnumbers. To find out if a specific portnumber is already in use type 'telnet hostname portnumber' in an MS-DOS window; if the connection cannot be made then the portnumber is unused. The format of the DAEMON line for an IRIS Explorer license is as follows: DAEMON NAG pathname NAG is the name of the NAG daemon (which also appears in the FEATURE line) and pathname is the pathname to the executable code for the daemon. Following the suggested location of the FLEXlm software in Section 4.1 the DAEMON line for PC license servers might be DAEMON NAG C:\FLEXLM\NAGLM\BIN\NAG.EXE and for Unix license servers DAEMON NAG /usr/local/flexlm/nag/bin/NAG Make sure that you edit the DAEMON line to reflect the location of the FLEXlm NAG daemon on your license server. You may place the license file on your license server anywhere you like, but following the location of the FLEXlm software suggested in Section 4.1 it is assumed that the license file on PC license servers will be located at C:\FLEXLM\NAGLM\LICENSE.DAT and for Unix license servers /usr/local/flexlm/nag/license.dat 4.3. Installing the Counted License File and FLEXlm Before you can run IRIS Explorer or an IRIS Explorer application on your PC you must complete installation of the license file and FLEXlm. Depending on which machine in the network is the license server you need to do the following: a) Your PC is the license server Set the environment variable LM_LICENSE_FILE on your PC to the full pathname of the license file on your PC in the way described in Section 3.3. b) Your PC is NOT the license server Set the environment variable LM_LICENSE_FILE on your PC to portnumber@hostname in the way described in Section 3.3. Here, portnumber and hostname must be the same as in the SERVER line (see Section 4.2). You will also need to start up the FLEXlm daemon on the license server (this daemon will start up the NAG daemon). Again, the following situations may apply: a) The license server is a Windows NT/2000 PC On the license server, in an MS-DOS window in the directory where you installed FLEXlm (e.g. C:\FLEXLM\NAGLM\BIN), type the command installs -e C:\FLEXLM\NAGLM\BIN\lmgrd.exe -c C:\FLEXLM\NAGLM\license.dat where the first parameter (-e) specifies the path to the lmgrd binary and the second (-c) specifies the path to the license file. A further option (-l) allows you to specify the path to a log file, which is where routine messages from lmgrd will be written. This will install the FLEXlm license daemon as an NT service. Now select "Settings" on the "Start" menu, and "Control Panel" on the submenu that appears. Double click on the "Services" icon to open up the "Services" window. "FLEXlm License Manager" will occur in the column "Service" (the list is in alphabetical order) and its "Startup" value will be "Automatic". Click on "Start" to start up the service (the "Status" column will now indicate the word "Started"). If you ever need to stop the service use the "Stop" button on the same window. You can remove the service altogether by typing installs -r in an MS-DOS window in the directory where you installed FLEXlm. NOTE: If you are upgrading from an older verson of IRIS Explorer using a counted license served from a Windows NT/2000 PC you must first stop the FLEXlm daemon and restart it using the binaries in the IRIS Explorer 5.0 distribution. To do this, follow these steps: 1) Stop the FLEXlm License Manager service using the "Services" window (see above). 2) In an MS-DOS window, change directory to %EXPLORERHOME%\license\bin\i86_n3 and use the INSTALLS program to remove the FLEXlm License Manager service: installs -r -n "FLEXlm License Manager" 3) Now modify the license file to add the FEATURE line for IRIS Explorer 5.0. You must add this so that it appears in the file before the old FEATURE line for IRIS Explorer. 4) Now use the INSTALLS program again, to install the new service: installs -e %EXPLORERHOME%\license\bin\lmgrd.exe -c C:\FLEXLM\NAGLM\license.dat where it has been assumed that the modified license file is in C:\FLEXLM\NAGLM. 5) Finally, use the "Services" window to start the new FLEXlm License Manager service. b) The license server is a Windows 95/98 PC On Windows 95/98 machines it is not possible to install FLEXlm as a service, and you will need to start the license daemon up in a window. This window needs to remain in existence as long as anyone on the network wishes to run IRIS Explorer. As such it may be easier to use another machine on your network as the license server. On the license server in an MS-DOS window in the directory where you installed FLEXlm type the command lmgrd -app A message will appear saying that FLEXlm and the NAG daemon have started. If you ever need to stop the daemon do so in a different MS-DOS window but in the same directory. Type lmutil lmdown c) The license server is a Unix machine On Unix machines the FLEXlm and NAG daemons may be started up automatically at reboot by one of the /etc/*rc* scripts (for example rc.local) with a command similar to (using the FLEXlm location suggested in Section 4.1) /usr/local/flexlm/nag/bin/lmgrd | sh -c \ 'while read line ; do echo "$line" >> \ /usr/local/flexlm/nag/lm_log ; done' & In this way the routine messages from lmgrd will be saved in the file /usr/local/flexlm/nag/lm_log and, if required, the file may be renamed without shutting down lmgrd. If you ever need to stop the daemon use the command lmutil lmdown in the directory where the FLEXlm software is installed. You can now run IRIS Explorer on your PC. You can also run IRIS Explorer on every other machine on the network where IRIS Explorer was installed as long as you have set the environment variable LM_LICENSE_FILE correctly on those machines. It should be set to the pathname of the license file on the license server and to portnumber@hostname on all other machines. Appendix - Contact Addresses NAG Ltd Wilkinson House Jordan Hill Road OXFORD OX2 8DR NAG Ltd Response Centre United Kingdom email: support@nag.co.uk Tel: +44 (0)1865 511245 Tel: +44 (0)1865 311744 Fax: +44 (0)1865 310139 Fax: +44 (0)1865 310139 NAG Inc 1400 Opus Place, Suite 200 Downers Grove IL 60515-5702 NAG Inc Response Center USA email: infodesk@nag.com Tel: +1 630 971 2337 Tel: +1 630 971 2345 Fax: +1 630 971 2706 Fax: +1 630 971 2346 Nihon NAG KK Yaesu Nagaoka Building No. 6 1-9-8 Minato Chuo-ku Tokyo Japan email: help@nag-j.co.jp Tel: +81 (0)3 5542 6311 Fax: +81 (0)3 5542 6312 [NP3564/IN - Revised]