Install

Ricardo Software Product and License Manager

Installation Guide

Version 10.8

PROPRIETARY NOTICE

This document is provided under the terms and conditions of the RICARDO SOFTWARE PRODUCT License Agreement,

wherein the Licensee has agreed not to disclose its contents, in whole or in part, to any third party outside of the Licensee Division and site designated in the Agreement.

The copyright of this software and associated documentation vests in Ricardo Software,

Ricardo, Inc., 7850 Grant St., Burr Ridge, IL, 60527-5852, U. S. A.

Unauthorized copying of this software and documentation is not permitted.

Ricardo, Inc. 2007

April 2007

i Ricardo Software Installation Guide Administrator’s Manual 10.8

Table of Contents QUICK INSTALLATION GUIDE.....................................................................................................1

INTRODUCTION .............................................................................................................................2

Ricardo Software Product and License Manager 10.8 Installation - Windows ......................3 1. Installation Requirements..................................................................................................3 2. Installation and Setup ........................................................................................................4

2.1 Option A – Full Installation.........................................................................................4 2.2 Option B – License Manager Installation Only ..........................................................7 2.3 License Manager Setup.............................................................................................8 2.4 Checking License Manager Status............................................................................9 2.5 Upgrading from RLM 7.0 to 10.8 (or 9.x) ................................................................10

Ricardo Software Product and License Manager 10.8 Installation - UNIX ...........................12 1. Installation Requirements................................................................................................12 2. Ricardo Software System Administrator Installation Guide............................................12

2.1 Mount the installation CD-ROM...............................................................................13 2.2 Installing products....................................................................................................15 2.3 Test workstations for required system files.............................................................17

3. Server Setup....................................................................................................................18 3.1 Single and triple (redundant) license servers..........................................................18 3.2 License Server Setup ..............................................................................................18 3.3 Upgrading from RLM 7.0 to 10.8 (or 9.x) ................................................................19

4. Workstation Setup ...........................................................................................................20 Ricardo License Manager Command Reference.....................................................................22

TROUBLESHOOTING..................................................................................................................23 Things to try before contacting support ...................................................................................23 General Error Messages .........................................................................................................24 Windows Specific Error Messages..........................................................................................26 UNIX Specific Error Messages................................................................................................27

1 Ricardo Software Installation Guide Administrator’s Manual 10.8

QUICK INSTALLATION GUIDE

The Ricardo Software License Manager (RLM) 10.8 is a FLEXlm-based licensing system that controls the execution of licensed Ricardo Software products.

The following briefly outlines the installation procedure for Ricardo Software products on Windows and UNIX:

WINDOWS

1) Place CD in CD-drive; 2) Select the directory into which the products will install; 3) Select which products to install; 4) At a command prompt execute the rlmhostid command. Send your hostname and

hostid to [email protected] to obtain your FLEXlm based license keys; 5) For license servers, at a command prompt execute the rlmsetuprestart

command; 6) When you receive your license file place it in <INSTALLDIR>/licmgr/licenses,

rename the file to ricardo.lic (if is not already called this), and reboot the machine.

UNIX

1) Place CD in CD-drive and mount the CD; 2) Navigate to CD mount point and run ./INSTALL; 3) Select the directory into which the products will install; 4) Select which products to install; 5) With <INSTALLDIR>/bin in your PATH, run rlmhostid at a command prompt

and send your hostname and hostid to [email protected] to obtain your FLEXlm based license keys;

6) When you receive your license file, place it in <INSTALLDIR>/licmgr/licenses and rename the file to ricardo.lic (if is not already called this);

7) Move to your system startup directory (e.g., /etc/init.d) and run ./rlmgrd start (or equivalent) to start the license manger for the first time.

The specific instructions for Windows and UNIX installations are described in the following sections.


INTRODUCTION

The Ricardo License Manager (RLM) 10.8 is a FLEXlm based licensing system that controls the execution of licensed Ricardo Software products. It is an upgrade of the RLM 9.x software and can control all 10.x, 9.x and 7.x licensed products. Below is a list of RLM 7.x and 9.x licensed versions of each software product, with the exception of CAMSPRING, which uses the ELAN License Manager. RLM 9.0 or above is required for those versions of software listed in the 9.x column. RLM 10.x is fully compatible with 9.x, if you are currently running RLM 9.x, you do not need to upgrade to RLM 10.8.

The Ricardo License Manager will run independently of any other existing FLEXlm license manager for other software products. RLM 10.8 uses version 10.8.5 of FLEXlm. If the existing license manager uses a later version of FLEXlm, you must ensure that the PATH environment variable points to the Ricardo License Manager path before the existing license manager path. We strongly suggest that you upgrade to the latest versions of our software, if you have not already done so. Software is now available for download from www.software.ricardo.com. If you require a login and password for the site, please contact Ricardo Software Support via e-mail at [email protected].

Product RLM 7.x RLM 9.x

WAVE 3.6.1 5.2

VECTIS 3.6 3.9

ENGDYN 3.0 4.0

VALDYN 2.6 3.0

PISDYN 3.2 4.0

RINGPAK 4.1 4.3

RAPID 2.1 4.0

TRIBFE 1.3 1.4

RPLOT 2.30 2.40

SDFBROWSER 1.18 -

FEARCE 5.7 6.0


Ricardo Software Product and License Manager 10.8 Installation - Windows

1. Installation Requirements

• PC running Windows 2000/XP • A 300Mz Pentium II to achieve adequate performance • A minimum of 256 MB RAM • 4+ GB disk space • 1024 x 768 16-bit color graphics or better • 19+ inch monitor • 16 bit sound card • Network Card • 3 Button Mouse

IMPORTANT: To perform the install you MUST have Windows Administrator privileges. Install the Products and License Manager. The software installation contains each of the Ricardo Software products (e.g., WAVE, VECTIS, VALDYN, etc.) as well as the License Manager software and some necessary helper applications.

Each Windows client machine must have the product(s) installed individually, but do not necessarily need the License Manager software. Typically, only the client License Manager software is installed per machine to allow display of license status information, for example.

The License Manager server software should be installed on a central machine, accessible to every user. In addition, the License Manager server software may need to be installed on laptops that are detached from the network and have their own license server.


2. Installation and Setup

2.1 Option A – Full Installation

1. It is strongly recommended that all programs be closed when you begin installation. Begin the installation process by either placing the installation CD in the drive or by executing the downloaded installation archive. For CD installations, the CD-ROM AutoPlay feature should start the process or, if AutoPlay is disabled, double-click the CD drive contained the installation CD.

2. This is the first screen you will see. Select the Next button to proceed with the installation.

3. It is important that you read the License Agreement that is presented to you on the next

screen. When finished, select the Yes button to accept the License Agreement. Selecting No will terminate the installation.


4. You will be asked to specify where you want your Ricardo Software to be installed. The default installation location is C:\Program Files\Ricardo. If you choose to install to a different location, Browse to the folder where you want your Ricardo Software products to be installed. When ready to proceed, select the Next button.

5. You will be given an opportunity to select the components you wish to install (the example

here may not be exactly the same as your screen, the software that is displayed will depend on which software distribution package is being used).

Be sure a check mark is inserted in front of each component you wish to install (ensure you have selected the Ricardo License Manager) and then select the Next button. Note that you can choose not to install the example files to conserve disk space.


6. A status bar will appear showing you the progress of the installation.

7. When you see the "InstallShield Wizard Complete" message, select the Finish button.

Once the software installation process has completed, all that remains is to inform the client machine of the location of the license file. This can be done by clicking START -> Programs -> Ricardo -> License Manager -> Environment Setup 10.8 and entering either the hostname of the single license server, or each hostname of the license triad. You do not need to be an administrator to do this (see screenshot below):


In general, use of a License Server specification is recommended over a License File as former uses cached information on the server. Note that you may optionally include a port number if required by your site, check with your local IT. This port number must also then be located in the ricardo.lic file on the SERVER line as an optional fourth field. For a triple license server arrangement, you are required to enter a port number on the SERVER lines or keep the default 1522 that is reserved by the Ricardo License Manager (see Registered Port Numbers). 2.2 Option B – License Manager Installation Only

Since Windows client must have the product(s) installed locally, there is no need to install the Ricardo Software product(s) on a Windows file server. The Ricardo License Manager, however, should be installed onto a central server, either from a Ricardo Software CD, or by downloading it from the Ricardo Software website: http://www.software.ricardo.com/.

Note that you must select the License Server feature in addition to the Client Files during the installation process to install the required programs that are needed for a license server.

Do not install the Ricardo License Manager in C:\FLEXlm as this is a special directory used by FLEXlm itself.


2.3 License Manager Setup

IMPORTANT: To perform the setup you MUST have Windows Administrator privileges.

1. Once the License Manager has been installed, open a Command prompt and type the command:

rlmsetuprestart

2. After this is done, reboot the machine.

3. In order to receive your license keys from Ricardo Software support, open a Command

prompt, run the commands hostname and rlmhostid, and then send the output to [email protected].

4. Your license keys will be sent to you via e-mail, contained within a ricardo.lic file. Copy

this ricardo.lic file into the <INSTALLDIR>/licmgr/licenses directory. Depending on whether this is a first request for licenses or additional licenses, you should either overwrite or append to the existing ricardo.lic file.


2.4 Checking License Manager Status

1. Select Start -> Settings -> Control Panel -> Administrative Tools -> Services

Scroll through the list of services and double click Ricardo License Manager 10.8

2. In the window that appears, ensure that Startup type is set to Automatic and then press the Start button.


This concludes the installation of the license manager on a Windows server.

2.5 Upgrading from RLM 7.0 to 10.8 (or 9.x)

If installing a product requires RLM 9.5 or above (see the table found in the INTRODUCTION), RLM 7.0 should first be shutdown and uninstalled prior to installing RLM 10.8.

In order to shutdown the RLM 7.x license server, use the procedure outlined in section 2.4 above to stop the server as shown in the following using the Stop button. Note that this will terminate any existing Ricardo Software products currently running. Following this, use the rlmsetuprestart command with a remove argument to completely remove the Ricardo License Manager 7.0 service (see next page).

RLM 10.8 (and 9.x) uses ricardo.lic as the license file name whereas RLM 7.x used license.dat. An existing license.dat can simply be renamed/copied to ricardo.lic if no products require RLM 9.x (again, see the table in the INTRODUCTION). However, if some products require RLM 9.x or above, a new ricardo.lic file will need to be obtained from Ricardo Software support ([email protected]).



Ricardo Software Product and License Manager 10.8 Installation - UNIX

1. Installation Requirements

• 256 MB RAM minimum • CD-ROM Drive • 1280x1024 8-bit graphics • FORTRAN, C/C++, Motif and OpenGL runtime libraries • 4+ GB disk space • OpenGL graphics hardware for enhanced performance.

2. Ricardo Software System Administrator Installation Guide

This documentation will assist system administrators when installing Ricardo Software products on workstations in a networked environment. The commands listed in the following sections will require root privileges and/or access to protected file systems. Please follow the instructions as carefully as possible in the order presented. Note that some knowledge of UNIX commands is assumed.

The Ricardo Software installation scheme is sufficiently flexible to allow installation to be performed on one type of workstation for another type of workstation if a CD-ROM drive is not available on the destination workstation (as long as both have NFS access to the installation directory). Similarly, the Ricardo Software License Manager need not be installed on the execution workstation/platform. During the installation process, various queries are made to determine where to install the software, what products to install and what platforms to install executables for.

Also note that failed installations can be completely removed (via rm -rf) and simply repeated.


2.1 Mount the installation CD-ROM

Mounting the installation CD-ROM usually requires root privileges and is platform specific. Please see the appropriate section for your platform. Note that the CD-ROM mount point may need to be created with the mkdir command.

SGI Mounting a CD-ROM under IRIX 6.5.x can be accomplished in two different ways, either automatically by mediad or manually via the mount command.

By default, most systems use the automatic method, which only requires that the CD-ROM be placed in the drive. The system automatically mounts the CD-ROM at the /CDROM mount point.

To mount the drive manually requires the following command:

mount -t iso9660 -o ro /dev/scsi/scxdyl0 /CDROM

where x is the controller number (0 or 1) and y is the SCSI ID (usually 4) of the CD-ROM drive and /CDROM is the mount point.

IBM Mounting a CD-ROM under AIX 5.x can be accomplished manually with the following command:.

mount -v cdrfs -o ro /dev/cdx /CDROM

where x is the drive number (usually 0) of the CD-ROM device and /CDROM is the mount point.

HP Mounting a CD-ROM under HP-UX 11.x can be accomplished manually with the following command:

mount -r -F cdfs /dev/dsk/c0t0dx /CDROM

where x is the SCSI ID (usually 4) for the CD-ROM drive and /CDROM is the mount point.

SUN Mounting a CD-ROM under Solaris 7+ is handled automatically. Note that the CD-ROM is usually mounted at a custom mount point, but is accessible from the /cdrom/cdrom0 symbolic link.

AXP Mounting a CD-ROM under Tru64 5.x can be accomplished manually with the

following command:

mount -r -t cdfs /dev/disk/cdrom0x /CDROM where x is the SCSI ID (usually c) of the CD-ROM drive and /CDROM is the mount point.

LNX Mounting the CD-ROM under Linux can be accomplished manually with the following command:


mount -t iso9660 /dev/cdrom /CDROM where /CDROM is the mount point.

Once the above is accomplished, the installation continues from the CD-ROM mount point which, for the following discussion, will be referred to as /CDROM.


2.2 Installing products

Installing Ricardo Software products from an installation CD-ROM or downloaded distribution is accomplished by executing the install (or INSTALL) script at the root of the /CDROM mount point or distribution directory as shown below:

% cd /CDROM (or distribution directory) % ./install The install script searches the directory for Ricardo Software products and presents the following screen:

The first query is whether or not the terms of the license agreement are accepted. The default answer is ‘n’ so you must type ‘y’ to continue.

Next, the installation directory needs to be designated. This directory must be on a partition with sufficient space and must be accessible to all users needing to use the software (in terms of directory permissions and NFS availability). Note that the directory will be created if necessary and should contain Ricardo as a trailing component for future reference.

Pressing Enter uses the default installation directory of /usr/Ricardo. Also note that this directory should be used for all future Ricardo Software product installations. It is not recommended to install Ricardo Software products in separate directories as this complicates the search path. The Ricardo Software installation scheme is fully capable of maintaining multiple products and multiple versions and does not require separate directories for these.

Given the installation directory, the install script next queries for which products to install:

By default, all products are installed. However, if some products are not licensed, disk space can be conserved by not installing the product(s). To install selected products, enter a space-delimited list of product names as they appear above. The licmgr product is the Ricardo License Manager and only needs to be installed on the license server(s).

----------------------------------------------------------------- RICARDO SOFTWARE INSTALLATION DRIVER

----------------------------------------------------------------- Please hit any key to view the license agreement

<License Agreement> Do you accept the terms of this license agreement? [n]: y Please enter installation directory (or ‘quit’) [/usr/Ricardo]:

The following Ricardo Software Products are available for install:

wave pisdyn ringpak engdyn valdyn licmgr

Please enter the product names to install (or ‘none’) [all]:


Once the product names are given, the install script begins sequentially installing each product composed of platform independent files (examples, scripts, etc.) and platform dependent executables. All the platform independent files are automatically installed.

For each product, another query of the platforms to install executables for and whether example files are desired as shown in the following screen:

A list of site-specific platforms should normally be entered (space-delimited as before) to eliminate unnecessary platforms. As before, pressing ENTER installs all platforms. This process is repeated for each product.

NOTE: After the installation is complete, the install script displays a path that needs to be added to each user's PATH environment variable. This should be set in either the .cshrc or in the .profile file.

For the valdyn V4.1 product, the following platforms are available:

axp hp ibm lnx sgi sun

Please enter the platform names to install (or ‘none’) [all]: Install example files for valdyn V4.1 [y]:


2.3 Test workstations for required system files

Some Ricardo Software products require system files that may not have been installed by default. These usually consist of runtime support for FORTRAN 77, C, C++, OpenGL and X/Motif but also include missing files caused by workstation vendor installation issues.

Each individual workstation on which Ricardo Software products will run should be tested using the bin/testplat script, which is installed in the directory specified in Section 2.2.

Although not guaranteed to be comprehensive, this script tests for the existence of system filesets which can be missing and prevent Ricardo Software products from functioning.

For each workstation tested, the output of testplat should look like the following screen:

The number of Passed messages varies with the workstation being tested. If any other messages appear, they should clearly state how to address the problem. Most problems are resolved by installing extra software components from the vendor-supplied operating system installation media.

------------------------------------------------------------------------------- R I C A R D O S O F T W A R E I N S T A L L A T I O N T E S T E R ------------------------------------------------------------------------------- This script is used to check for the existence of standard system files that are required to run Ricardo Software products: Passed. Passed. Passed. Passed. Passed. Passed. Test successfully completed.


3. Server Setup

3.1 Single and triple (redundant) license servers

When installing the Ricardo License Manager, local system administrators have a choice of installing on a single license server, or installing on three license servers. The choice of one or three is dependant on the desired amount of redundancy in the system.

If only one server is used and the system is taken down or crashes, all currently running Ricardo Software products will terminate, since regular checks are made for active licenses during the course of their execution.

If a redundant set of three license servers is configured, license requests will be honored as long as two of the servers remain up.

The setup procedure is the same in both cases except that Ricardo Software support will need to know the hostname and hostid of all machines involved before requesting license keys via [email protected].

3.2 License Server Setup

IMPORTANT: To perform the setup you MUST have UNIX root privileges

1. For UNIX servers, the Ricardo Software product(s) needs to be installed on a server, along with the Ricardo License Manager. Both the software products and the License Manager can be installed either from a Ricardo Software CD or from a download from the Ricardo Software website: http://www.software.ricardo.com/.

2. Once the Ricardo Software products and License Manager have been installed, execute the ./rlmsetuprestart script as a privileged root user from the <INSTALLDIR>/licmgr/10.8/bin directory.

3. Run the hostname and rlmhostid scripts from a working directory (not from <INSTALLDIR>/licmgr/10.8/bin). Send the output of both commands to [email protected] to have license keys generated.

4. Your licenses will be sent to you via e-mail, contained within a ricardo.lic file. Copy this license file into the <INSTALLDIR>/licmgr/licenses directory. If this is your first request, overwrite an existing ricardo.lic file. However, if these are additional licenses, append the contents to the existing ricardo.lic file.

5. The command run in step 2 will have created a script (typically) named rlmgrd in a platform specific location (see table below). This script will automatically start the license daemon process when the system boots.

The license manager can be manually started or stopped from the startup directory (see table below) with the command ./rlmgrd start or ./rlmgrd stop.


You must manually start the license manager process for the first time by running ./rlmgrd start from one of the following directories:

6. This concludes the installation of the license manager on a UNIX license server. Each client machine must now be configured to locate the licenses from the license server.

3.3 Upgrading from RLM 7.0 to 10.8 (or 9.x)

If installing a product requires RLM 9.5 or above (see the table found in the INTRODUCTION), RLM 7.0 should first be shutdown and uninstalled prior to installing RLM 10.8.

In order to shutdown the RLM 7.x license server, use the ./rlmgrd stop command to halt the license server as shown in step #5 above. Note that this will terminate any existing Ricardo products currently running.

RLM 10.8 (and 9.x) uses ricardo.lic as the license file name whereas RLM 7.x used license.dat. An existing license.dat can simply be renamed/copied to ricardo.lic if no products require RLM 9.x (again, see the table in the INTRODUCTION). However, if some products require RLM 9.x or above, a new ricardo.lic file will need to be obtained from Ricardo Software support ([email protected]).

Platform Startup Directory/Script name SGI IRIX /etc/init.d/rlmgrd IBM AIX /etc/rc.rlmgrd HP HP-UX /sbin/init.d/rlmgrd Compaq Tru64 /sbin/init.d/rlmgrd SUN Solaris /etc/init.d/rlmgrd Linux /etc/rc.d/init.d/rlmgrd


4. Workstation Setup

Once the license server setup has been completed, workstations need only be informed about either the location of the ricardo.lic file, or the hostname(s) of the license server(s).

• In either case the RICARDO_LICENSE_FILE environment variable needs to be set with the correct information for the Ricardo Software products to access the licenses.

• If the server setup in the previous section has been completed using the default installation scheme (where the ricardo.lic file is installed in the <INSTALLDIR>/licmgr/licenses directory), the license file will be automatically detected by the scripts that launch the executables for each Ricardo Software product.

Note that the rlmgetservers script displays this information in this case.

• In a non-standard installation structure, the RICARDO_LICENSE_FILE environment variable can be set manually, as outlined below:

1. Direct path to ricardo.lic file, for example:

setenv RICARDO_LICENSE_FILE <INSTALLDIR>/licmgr/licenses/ricardo.lic

2. Single license server name, for example:

setenv RICARDO_LICENSE_FILE @server or

3. List of three license server names, for example:

setenv RICARDO_LICENSE_FILE 1522@server1:1522@server2:1522@server3

In the latter case, the 1522@ is required and corresponds to the UNIX port number of the Ricardo Software License Server. This number may be different for your site.

The above assumes UNIX C shell (csh) syntax and should be put in the user’s .cshrc file located in their home directory.

For Bourne (sh), K Shell (ksh) and Bourne Again Shell (bash), the syntax would be as follows:

1. Direct path to ricardo.lic file, for example:

RICARDO_LICENSE_FILE=<INSTALLDIR>/licmgr/licenses/ricardo.lic export RICARDO_LICENSE_FILE

2. Single license server name, for example:

RICARDO_LICENSE_FILE=@server export RICARDO_LICENSE_FILE

3. List of three license server names, for example:


RICARDO_LICENSE_FILE=1522@server1:1522@server2:1522@server3 export RICARDO_LICENSE_FILE

When using the above shells, the RICARDO_LICENSE_FILE environment variable would use the .profile file located in the user’s home directory.


Ricardo License Manager Command Reference The following commands are available on Windows and UNIX. All the commands are standard FLEXlm commands and more detailed documentation can be found in the FLEXlm End User Guide, which is also installed and located in the <INSTALLDIR>/licmgr/10.8/docs directory as a PDF file named LicensingEndUserGuide.pdf. The Ricardo Software commands have an ‘r’ in front of them (e.g., rlmhostid instead of lmhostid) and have been modified to include the ‘-c’ argument as necessary to point to the location of the ricardo.lic file. rlmhostid Generates a unique ID for a license server, which needs to be supplied to

Ricardo Software support (as well as the hostname ) to generate licenses. rlmstat Displays status information for the license servers including whether they are up

or down, and the number of checked out licenses per feature. This is the only command of interest to end users. rlmreread Rereads the ricardo.lic file on a server if it has been changed while the

server is currently running. For example, this command must be run if license features have been added to the license file.

rlmgrd Initializes the license daemon process on a license server depending on a start

or stop command line argument (see section 3.3). This command is typically not in the path but instead is in a platform specific location (see table in section 3.3) where it is used automatically at boot time.

rlmdiag -n Displays diagnostic information for debugging issues. Ricardo Software support

will ask for the output of this command only as necessary. rlmutil Generic command that can access all features of the FLEXlm licensing system.

Please see the FLEXlm End User Guide documentation for a more detailed description of the capabilities of this command.

rlmver Displays the version of FLEXlm implemented in a Ricardo Software product

executable. rlmdown Shuts down the Ricardo License Manager on the specific license server. rlmreread Rereads an updated ricardo.lic license file in

<INSTALLDIR>/licmgr/licenses and updates cached licensed features and counts.


TROUBLESHOOTING

Things to try before contacting support

1. For Windows: Open a command window and run rlmsetuprestart remove. Do not reboot your machine.

2. Assuming you have Win2K/XP, right-click My Computer and choose Manage. Open the Services and Applications tree and select Services. Scroll down the list on the right side and confirm that there isn't a Ricardo License Manager 10.8 entry. If there is, the above didn't work.

3. Run rlmsetuprestart. Reboot your machine.

4. Go back to Services as above and now confirm that there is a Ricardo License Manager 10.8 entry and it's marked as Automatic. If there isn't, the above didn't work. If there is and there is a valid license file in C:\Program Files\Ricardo\licmgr\licenses\ricardo.lic, reboot. After you reboot, go back to Services and confirm that the status is Started. In Task Manager, you should see a lmgrd.exe and a RICARDO.exe process.

If that doesn't help:

1. Check if C:\FLEXlm exists. It should just contain an empty file named RICARDO. If it exists, delete it. If it doesn't, just create the empty directory.

2. Run regedit and delete the HKEY_LOCAL_MACHINE\SOFTWARE\FLEXlm License Manager\Ricardo License Manager key. This will require you to use the Start->Programs->Ricardo->License Manager->Environment Setup 10.8 program again and reset it to your proper license server name or license file (assuming it is C:\Programs Files\Ricardo\licmgr\licenses\ricardo.lic).


General Error Messages

Error License server does not support this feature

Cause 1. This can be caused by not having a license for a particular feature. OR 2. When the command rlmreread fails to read an updated ricardo.lic file.

Solution 1. Contact Ricardo Software support to inquire about the feature and license. 2. Manually stop the rlmgrd and then restart.

Error

In the rlmgrd.log file:

15:44:35 (RICARDO) Connected to sleepy 15:44:35 (RICARDO) read: Connection reset by peer 15:44:35 (RICARDO) Lost connection to dumpy 15:44:38 (RICARDO) Lost quorum, exiting

Cause This is caused when running a triad server and one or more of the triad daemons is down or the daemons cannot talk to each other.

Solution

This can be solved by stopping the license manager on each of your three servers and restarting them at the same time. It is important that you ensure that port 1522 (or your custom port number) is free on all three servers before restarting the license managers. Typing netstat -a | grep <port #> will allow you to ensure the port number is free on each server before starting the license managers again. If this does not solve the problem, check network cable connections.

Error Cannot connect to the license server

Cause

1. This occurs when the server was rebooted before running the command rlmsetuprestart. OR 2. By not having the RICARDO_LICENSE_FILE environment variable set.

Solution

Make sure the ricardo.lic file is installed. Run the command rlmsetuprestart and reboot your machine.

UNIX csh: setenv RICARDO_LICENSE_FILE @servername

UNIX sh: RICARDO_LICENSE_FILE=@servername export RICARDO_LICENSE_FILE

Windows: Start->Programs->Ricardo->License Manager->Environment Setup. Set to server and input the server name.

Error Version 10.8 does not exist for rlmhostid

Cause This is caused when running ./rlmhostid from the <INSTALLDIR>/bin or <INSTALLDIR>/licmgr/10.8/bin directory.

Solution

To run the rlmhostid script, you must be logged in as a user and have <INSTALLDIR>/bin in your path. This script is run from a command prompt. Open a command window. Do not change from the default directory. At the prompt type: rlmhostid.


Error /usr/Ricardo/bin/wb[3]: rlmgetservers: not found

Cause This is caused when the Ricardo License Manager isn’t installed in the default location, adjacent to the other Ricardo Software products.

Solution

Install the Ricardo License Manager adjacent to the other Ricardo Software products if you wish to eliminate this message. However, in general, it can safely be ignored if the user has manually set a RICARDO_LICENSE_FILE environment variable and the products are working OK.

Error Cannot connect to license server (-15,12:79 "Connection refused")

Cause This can be caused by not having the Ricardo License Manager running or if the RICARDO_LICENSE_FILE environment variable is set to an incorrect server or license file location.

Solution

Ensure that the Ricardo License Manager is running on the license server(s). For UNIX, this should include an lmgrd and RICARDO process as seen with ps –ef. See section 3.2 for how to setup and start the license server. For Windows, the Task Manager Processes tab should show an lmgrd.exe and RICARDO.exe process. See section 2.3 for how to setup and start the license server.

Error

In the rlmgrd.log file:

14:38:58 (RICARDO) Wrong hostid on SERVER line for license file: 14:38:58 (RICARDO) /../Ricardo/licmgr/licenses/ricardo.lic 14:38:58 (RICARDO) SERVER line says abcbfc, hostid is "x0016238 x0016247 x0015406" 14:38:58 (RICARDO) Invalid hostid on SERVER line 14:38:58 (RICARDO) Disabling 1 license from feature )

Cause This is caused when the license is made with the wrong hostid.

Solution

Confirm the hostid by executing the rlmhostid command. Note that, on laptops with multiple network ports such as wired and wireless, multiple hostids may be shown with this command. Choose the hostid in the list that is predominantly used. On Windows, you may also need to set the following registry value to prevent Windows from shutting down a network port when a cable is unplugged, for example: [HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\Tcpip\Parameters] "DisableDHCPMediaSense"=dword:00000001


Windows Specific Error Messages

Error

Lost license, cannot re-connect: Server node is down or not responding. See the system administrator about starting the server or make sure you're referring to the right host (see LM_LICENSE_FILE) Feature: WAVE_WaveBuild License path: C:\Program Files\Ricardo\licmgr\licenses\ricardo.lic; C:\Program Files\Ricardo\licmgr\licenses\ricardo.lic FLEXlm error: -96,23 For further information, refer to the FLEXlm End User Manual, available at "www.globetrotter.com"

Cause This is caused by a currently running Ricardo Software product that loses contact with the license server.

Solution Check that the license server has not crashed or otherwise become inaccessible from the client system running the Ricardo Software program.

Error lmgrd is not running: Cannot connect to license server (15,10:10061 "WinSock: Connection refused")

Cause This can be caused when running on machine that also has the network firewall.

Solution

It has been found that McAfee VirusScan Home installs a firewall that blocks the ports used by the license servers. By un-installing the Home version and installing the site licensed Enterprise Edition the firewall is cleared and the machine will now talk to the license server.

Error

C:\> rlmsetuprestart Installing Ricardo License Manager 10.8 Service... Failed to install FLEXlm License Server: FLEXlm License Server is already installed FLEXlm License Server was not successfully installed on your system

Cause This is caused when the script rlmsetuprestart has been run more than once.

Solution

At a command prompt, type:

rlmsetuprestart remove

Press Return and then type:

rlmsetuprestart

Press Return. You should not need to reboot.

Error When trying to run a program (e.g., WAVE) I get a message:

Invalid returned data from license server

Cause This can be caused by having a McAfee VirusScan Home installed or possibly by using a non-default port number.

Solution

1. Un-install the Home version and install the site licensed Enterprise Edition the firewall. 2. The Ricardo License Manager Environment Setup 10.8 utility assumes the default port number of 27000 (not specified prior to the @ in the RICARDO_LICENSE_FILE variable) for a single license server and 1522 for a triple redundant license server. Use the Port Number field to enter your non-default port number. Alternatively, manually set the port number in the RICARDO_LICENSE_FILE environment variable by adding it prior to the @ ahead of


the license server hostname.

Error Could not start the Ricardo License Manager service on Local Computer.

Error 1067: The process terminated unexpectedly.

Cause This is usually due to problems in or a missing ricardo.lic file. It can also be caused by missing FLEXlm executables.

Solution

1. Confirm that the ricardo.lic file is present in <INSTALLDIR>\licmgr\licenses.

2. Confirm its contents are as you’ve received from Ricardo Software support.

3. Confirm that the following executables are present in <INSTALLDIR>\licmgr\10.8\exe:

installs.exe lmgrd.exe lmutil.exe RICARDO.exe RLMSETUP.exe

UNIX Specific Error Messages

Error

I created a directory called licenses under the licmgr directory and added the ricardo.lic file there. I tried to start the /etc/init.d/rlmgrd start script but it is asking for a password.

Cause

The problem is that the rlmgrd does not allow the user to specify where the log file should be written. The permissions on your guest account are such that a user cannot run rlmgrd because the program would try and create a log file in <INSTALLDIR>/Ricardo/licmgr/licenses directory.

Solution

Global write permissions need to be turned on for the licenses directory for the guest account to be able to write into it. Once you change the permissions, the daemon should run correctly. Alternatively you can run rlmsetuprestart again and use a different account.

Error After running rlmsetuprestart command, it makes the 0 byte size file named rlmgrd in /etc/rc.d/init.d

Cause This is caused when the command rlmsetuprestart is run from the wrong directory.

Solution To set up the license server, execute the rlmsetuprestart script as the root user from the <INSTALLDIR>/licmgr/10.8/bin directory.

Documents

Install