Release and Installation Notes for GG Ver 2.0 Installation Notes 1) If you have not requested your new licenses, then you must call or email Utilitek Systems to request them. You must designate a machine to be a server to use the new Flexlm licensing. You must supply the hostname and hostid of your server machine. If you have chosen to use node locked (non floating) licenses, then you must supply the hostids of all computers that will run the software. Host names can be determined by using the Unix hostname command. To determine your hostid, use one of the commands list below: For HPUX -> /etc/lanscan For Sunos -> /bin/hostid For Solaris -> /bin/hostid Email this output to Utilitek Systems or call and you will recieve your authorization codes shortly. Via email to support@utilitek.com Via phone 607-786-9064 x22 2) cd to an available temp directory on your system. Any temp area will work, with /usr/tmp and /tmp being the most common temp areas. 3) Download the GeomGen compressed tar file from the Utilitek Web Site. Using a web browser navigate to www.utilitek.com/misc/download.htm and select the version of the software which is applicable to your workstation. You must also download the installation script. 4) Decide where on your system the Utilitek tools will reside. This directory is refered to at UT_HOME. This directory must be accessable via NFS file access to all users of the Utilitek tools 5) Type sh install The install script will run. If errors occur during the installation proccess, correct them and re-issue the install command. Release Notes Version 2.0 of the Geometry Generator now uses Flexlm licensing. This allows users to now benefit from full floating licenses. The version of Flexlm is 6.1b. Licensing This section is not intended to be a full description of how to setup or use all of the features of Flex licensing. A complete html based Flexlm user's reference manual has been included under the doc directory. If you are not familiar with Flexlm licensing or wish to understand more about, you can read the online docs using any web browser. A table of contents and an index html file have both been provided. You can either navigate to this directory using your web browser or invoke the web browser directly on the required file. e.g. netscape $UT_HOME/doc/htmlman/flexuser/IX.htm to open the index or netscape $UT_HOME/doc/htmlman/flexuser/TOC.htm to open the table of contents This manual will provide you with much more indepth usage information on Flexlm. It is not recommended that you mix licenses or Flexlm utilities. Different versions of Flexlm utilities are downward compatible, but not upward compatible. That is to say a version 6.1b license server can serve licenses for older version of flex tools, but older versions (6, 5.1, ...) of Flex license servers cannot serve licenses to a version 6.1b tool. The flex routines require a licensing environment variable be set to direct the license routines to the license file. It is possible to use Utilitek's tools in conjunction with the use of the LM_LICENSE_FILE variable, BUT IT IS NOT RECOMMENDED. It is very highly recommended that the UT_LICENSE_FILE variable be used. This will seperate your Utilitek licenses from any other flex licenses. This will remove you from any possible problems due to mixed versions of the Flex routines, or bad licenses from another vendor causing licensing errors. For convienience a 4 tier license search tree has been established. 1) all license files pointed to by LM_LICENSE_FILE are searched 2) (RECOMMENDED) all files pointed to by UT_LICENSE_FILE are searched 3) $UT_HOME/license.dat is searched 4) /usr/utilitek/license.dat is searched. Any user of the GeomGen tool must have the following environment variables set to correctly operate the tool. Required environment variables AMPLE_PATH UT_HOME LM_LICENSE_FILE or UT_LICENSE_FILE The first 2 variables have always been required. The last variable is a new requirement to use flex licensing. In the following examples substitute the file system path name of your Utilitek supplied license file any place that you see the string "Utilitek License path". For each user who will use GeomGen: If they use Korne (ksh) or Borne (sh) shell: Add to the end of their .profile file: UT_HOME='UT_DIR' export UT_HOME If they already have AMPLE_PATH set: AMPLE_PATH=${AMPLE_PATH}:\$UT_HOME/userware If they do not have AMPLE_PATH set: AMPLE_PATH=\$UT_HOME/userware export AMPLE_PATH If you choose to use LM_LICENSE_FILE then If they already have LM_LICENSE_FILE set: LM_LICENSE_FILE=${LM_LICENSE_FILE}:"Utilitek License path" export LM_LICENSE_FILE If they do not have LM_LICENSE_FILE set: LM_LICENSE_FILE="Utilitek License path" export LM_LICENSE_FILE If you choose to use UT_LICENSE_FILE then UT_LICENSE_FILE="Utilitek License path" export UT_LICENSE_FILE If they are using C (csh) shell: Add to the end of their .cshrc file: setenv UT_HOME 'UT_DIR' If they already have AMPLE_PATH set: setenv AMPLE_PATH ${AMPLE_PATH}:\$UT_HOME/userware If they do not have AMPLE_PATH set: setenv AMPLE_PATH \$UT_HOME/userware If you choose to use LM_LICENSE_FILE then If they already have LM_LICENSE_FILE set: setenv LM_LICENSE_FILE=${LM_LICENSE_FILE}:"Utilitek License path" If they do not have LM_LICENSE_FILE set: setenv LM_LICENSE_FILE="Utilitek License path" If you choose to use UT_LICENSE_FILE then setenv UT_LICENSE_FILE="Utilitek License path" Demo Mode Install If this is a demo installation, then you must customize your installation in order to run the demo software. When you have your UT_HOME and your AMPLE_PATH variables set then execute the command $UT_HOME/bin/setup_data_file. You will be supplied with a series of numbers and instructed to call Utiltek at (607) 786-9064. The support staff at Utilitek will inturn supply you with a set of hexadecimal numbers that will configure your installation, type in the hexadecimal numbers when requested to. This finishes the customization of a demo installation. License File When you receive your license file from Utilitek Systems, you will have to perform a minor edit on the file. Open the file in an editor and edit the second line. Change the string that says "path to your UT_HOME" to the path on your system that points to the UT_HOME area. Also if you did not supply the name of your server node when you requested your licenses, then the string in the first line that says "unamed_server" must be changed to the actual name of your license server. Starting the License Server The license daemon must be started on your license server machine. This command can be entered manually or added to the system startup files to start the license server every time the server machine boots. Issue the following command: $UT_HOME/bin/lmgrd -c "path to your Utilitek License file" Checking license status At any command line issue the following command: $UT_HOME/bin/lmstat [-a] The -a switch produces verbose output about license availability and current use. Starting up GeomGen Start a new librarian session: Close any Notepad windows which are displaying messages. Select the Utilitek Menu in the top banner window, then choose GeomGen. For your convience the Stroke G will also run GeomGen. The first invocation of GeomGen may take a while, as it is creating an internal database in librarian. Select a geometry style. Press Ok. Enter the apropriate values for the fields you are presented with. Press Ok. Your geometry is now being created. You may create another geometry by selecting GeomGen again. It will run significantly faster this time. There are also several other GeomGen menus avaialble. If you select the Utilitek Menu in the top banner window, then choose GeomGen and while holding the mouse button down slide your cursor to the right to disclose the GeomGen sub menu. Menu picks are present to allow you to create a geometry in any of the following manners: 1) popup a form that contains data from the last geometry created 2) to create a geometry from an internal IPC RLP database 3) from a database of any previously created geometry or 4) to create a geometry from an external comma seperated value list Issues During testing a memory leak was discovered. The leak only manifests itself on SUNOS at B2 and higher Mentor versions and on HPUX at C1 and higher Mentor versions. The leak is approximately 0.75 megabyte per geometry created. This should not affect anyone in normal use, but it would affect someone rebuilding an entire library, or generating several hundred geometries in a single session. This leak is currently being investingated and will be repaired in a future release.