Center for Advanced Decision Support for Water and Environmental Systems

Page 1 of 13

R I V E R W A R E L I C E N S E S E R V E R C O N F I G U RA T I O N G U I D E

This document is for RiverWare users with a network floating license Last Updated 4252018

TABLE OF CONTENTS

Introduction 1

License Server Program Files 2

Floating License Certificate File 2

License File Format 2

Specifying Port Numbers 3

Starting License Server 3

Accessing License Server from a Client Machine 5

License Server Administration Tools 6

The RLM Web Server (the preferred method) 6

Command-line Tools 9

Shutting Down the License Server 10

Using the RLM Web Server Interface 10

Using the Command Line 10

Running License Server as a Windows Service 10

Troubleshooting 12

Contact RiverWare LicenseInstallation Support 13

INTRODUCTION

This document is intended for users who have a RiverWare network floating license and will be running RiverWare version 6x and later releases To set up a license server for running RiverWare 5x and prior releases please contact install support at installsupportcoloradoedu for additional information A RiverWare network floating license allows a specific number of licenses to be checked out to any computer that is on your local network at any one time The number of the license is defined in the license certificate file This type of license requires a license server manager to be running on a license server machine to administer the RiverWare license usage The license server manager uses very little CPU time and memory Therefore the license server machine does not need to be a powerful machine but it must be accessible to other client computers on the network running RiverWare application

Center for Advanced Decision Support for Water and Environmental Systems

Page 2 of 13

This document provides specific instructions for installing and configuring a RiverWare RLM license server on a Windows system In addition the RLM License Administration Manual describes more detailed setup and maintenance of the RLM licensing system It can be obtained from the Reprise Software Website httpwwwreprisesoftwarecomadminsoftware-licensingphp

LICENSE SERVER PROGRAM FILES

Following are the required program files for starting a license server manager

cadswesset

rlmexe

rlmopt

rlmutilexe There are two ways to obtain these files

Download and install one of the RiverWare 6x or later releases and find them in the subfolder reprise under the directory where RiverWare is installed o Point your browser to httpcadswes2coloradoedudownloadsriverwarereleases o Click on a release version to download the RiverWare install program Email

installsupportcoloradoedu to request the login information o Execute the downloaded RiverWare install program to start the install process o Find the license server program files in the subfolder reprise under the directory where RiverWare is

installed

Download only the license server program files from the CADSWES Download RiverWare web page o Point your browser to httpcadswes2coloradoedudownloadsriverwarereleases o Go to section ldquoSupporting Applications and Librariesrdquo o From the ldquoRiverWare network license server programs (for floating license users only)rdquo section select

ldquo32-bitrdquo to download the zip file rwlicenseserver-win32zip select ldquo64-bitrdquo to download the zip file rwlicenseserver-win64zip

o These zip files include only the license server program files and the RLM License Administration manual

It is strongly recommended that you always use the latest license server programs to run your license server

FLOATING LICENSE CERTIFICATE FILE

The RiverWare floating license certificate file contains information that configures the license server and describes all the license rights granted to the user It is delivered to users via electronic email The license file is always named cadsweslic and it is recommended that users preserve the filename The license file must be saved in plain ASCII text file format

License File Format

A RiverWare floating license file has four types of lines

HOST Specify the name of the license server host

ISV Specify the CADSWES license server information

LICENSE

Center for Advanced Decision Support for Water and Environmental Systems

Page 2 of 13

This document provides specific instructions for installing and configuring a RiverWare RLM license server on a Windows system In addition the RLM License Administration Manual describes more detailed setup and maintenance of the RLM licensing system It can be obtained from the Reprise Software Website httpwwwreprisesoftwarecomadminsoftware-licensingphp

LICENSE SERVER PROGRAM FILES

Following are the required program files for starting a license server manager

cadswesset

rlmexe

rlmopt

rlmutilexe There are two ways to obtain these files

Download and install one of the RiverWare 6x or later releases and find them in the subfolder reprise under the directory where RiverWare is installed o Point your browser to httpcadswes2coloradoedudownloadsriverwarereleases o Click on a release version to download the RiverWare install program Email

installsupportcoloradoedu to request the login information o Execute the downloaded RiverWare install program to start the install process o Find the license server program files in the subfolder reprise under the directory where RiverWare is

installed

Download only the license server program files from the CADSWES Download RiverWare web page o Point your browser to httpcadswes2coloradoedudownloadsriverwarereleases o Go to section ldquoSupporting Applications and Librariesrdquo o From the ldquoRiverWare network license server programs (for floating license users only)rdquo section select

ldquo32-bitrdquo to download the zip file rwlicenseserver-win32zip select ldquo64-bitrdquo to download the zip file rwlicenseserver-win64zip

o These zip files include only the license server program files and the RLM License Administration manual

It is strongly recommended that you always use the latest license server programs to run your license server

FLOATING LICENSE CERTIFICATE FILE

The RiverWare floating license certificate file contains information that configures the license server and describes all the license rights granted to the user It is delivered to users via electronic email The license file is always named cadsweslic and it is recommended that users preserve the filename The license file must be saved in plain ASCII text file format

License File Format

A RiverWare floating license file has four types of lines

HOST Specify the name of the license server host

ISV Specify the CADSWES license server information

LICENSE

Center for Advanced Decision Support for Water and Environmental Systems

Page 3 of 13

Describe the license rights granted to the user

Lines starting with ldquordquo describe the license administrative information

Specifying Port Numbers

Some firewalls require that port numbers be specified to the firewall The RiverWare license file is always issued without the TCPIP port number specified To configure your firewall to allow access to the specific port number add the port number to the license file in the following format

HOST line The default port number for the RLM generic license server is 5053 It can be changed to any other available port Host lthost namegt lthost IDgt [port]

For example Host rwserver 123456ABCDEF 6001

ISV line

The port number for the CADSWES license server should normally be omitted But it can be specified if you need to access it across a firewall ISV CADSWES [port=port]

For example ISV cadswes port=6002

IMPORTANT NOTES The only changes allowed in the license key are the host name and the TCPIP port number on the HOST line or the ISV line Any other changes to the license file will invalid the license Any line that starts with ldquordquo contains the administrative information for the license file and does not affect the license key

STARTING LICENSE SERVER

Follow the steps below to start a RiverWare license server on the machine

Log on to the machine The administrator privilege is not required for starting a RiverWare license server

Create a RiverWare license server folder on the machines local hard drive which will be dedicated for running the RiverWare license server For example Crwlicserver (This folder will be referred as ldquoRiverWare license server folderrdquo from now on)

Copy the required license server program files (cadswesset rlmexe rlmopt and rlmutilexe) to the new RiverWare license server folder you have just created

Save a copy of your cadsweslic file to the new RiverWare license server folder you have just created

Launch a Command Prompt window and change the current directory to the new RiverWare license server folder you have just created

Execute the following command to start the license server assuming all program files are located in Crwlicserver directory

rlm -c Crwlicservercadsweslic -dlog Crwlicserverdebuglog (Run the web server on default port 5054)

Center for Advanced Decision Support for Water and Environmental Systems

Page 4 of 13

OR rlm ndashc Crwlicservercadsweslic ndashdlog Crwlicserverdebuglog ndashws 6003 (Run the web server on port 6003 instead of default 5054)

where -c

Specifies the location of the license file cadsweslic The file name should be entered with the full directory path included

-dlog Specifies the location of the file for RLM generated debug log The file name should be entered with the full directory path included Note that name debuglog is just a sample you can name it to anything you prefer

-ws Optional Specifies the port for the web server where is the desired port number The default is 5054 (The web server is the license server administration tool that is described later in this document)

IMPORTANT NOTES The license server will be shut down if you close the Command Prompt window that started the license server To keep the license server up and running all the time install the license server as a Windows service process Refer to later section ldquoRunning RiverWare License Server as a Windows Servicerdquo for more details

To verify RiverWare license server has started successfully check the following

o Start a Windows Task Manager Find rlmexe and cadswesexe processes running on the machine o View the debuglog file It can also be accessed through the RLM web server by selecting the ldquoSHOW rlm

Debug Logrdquo from the Status window The contents of the log file should look similar to the following (where lthostnamegt is the name of the license server machine and ltmacaddgt is the MAC address of the licenser server machine) 0419 1131 (rlm) RLM License Server Version 120BL2-p2 Copyright (C) 2006-2015 Reprise Software Inc All rights reserved 0419 1131 (rlm) License server started on danshuei 0419 1131 (rlm) Server architecture x64_w3 0419 1131 (rlm) License files 0419 1131 (rlm) Crwlicservercadsweslic 0419 1131 (rlm) 0419 1131 (rlm) Using options file rlmopt 0419 1131 (rlm) Web server starting on port 5054 0419 1131 (rlm) Using TCPIP port 5053 0419 1131 (rlm) adding UDPIP port 5053 0419 1131 (rlm) Starting ISV server cadswes on port 65182 0419 1131 (rlm) New thread created to watch ISV cadswes 0419 1131 (cadswes) RLM License Server Version 120BL2-p2 for ISV cadswes 0419 1131 (cadswes) Settings from RLM Version 120BL2 for ISV cadswes 0419 1131 (cadswes) Server architecture x64_w3 Copyright (C) 2006-2015 Reprise Software Inc All rights reserved RLM contains software developed by the OpenSSL Project for use in the OpenSSL Toolkit (httpwwwopensslorg)

Center for Advanced Decision Support for Water and Environmental Systems

Page 5 of 13

Copyright (c) 1998-2008 The OpenSSL Project All rights reserved Copyright (c) 1995-1998 Eric Young (eaycryptsoftcom) All rights reserved 0419 1131 (cadswes) 0419 1131 (cadswes) Server started on danshuei (hostid 180373ae77cf) for 0419 1131 (cadswes) riverware rlm_roam 0419 1131 (cadswes) 0419 1131 (cadswes) License files 0419 1131 (cadswes) Crwlicservercadsweslic 0419 1131 (cadswes)

ACCESSING LICENSE SERVER FROM A CLIENT MACHINE

For RiverWare to find a license server license file cadsweslic needs to be in the parent directory (ie one level up) from where RiverWare is installed This is the default location for RiverWare to search for a license file For example If RiverWare 70 is installed in CcadswesRiverWare 70

then your cadsweslic should be at Ccadswescadsweslic

o This cadsweslic can be the entire copy of the original cadsweslic file or a file that contains only the HOST line from the original cadsweslic file The HOST line lists information for the host name the host ID and the port number (if it is specified in the license file)

o License file cadsweslic must be saved in plain ASCII text file format Do not save it in Word format Rich text format or any other similar encoding

o It is recommended that users preserve the file name Do not make any changes to the saved cadsweslic file

o Make sure that there are no other files that have a file name extension of lic exist in the same directory where cadsweslic file is located

After RiverWare has started successfully the user can find out where RiverWare obtained the license by doing the following o In RiverWare Workspace window click Help gt About RiverWare o The section ldquoLicense Informationrdquo displays the version of the license manager and the license file used

when starting RiverWare

Center for Advanced Decision Support for Water and Environmental Systems

Page 6 of 13

If RiverWare encounters any problem when trying to access a license file a Command Prompt window will

appear and display an error message Email the error to RiverWare Install Support at installsupportcoloradoedu The error message can be obtained in one of the following two ways o The error output file

The location of it is displayed in the Command Prompt window after the line This message has been written to the file

o The screen shot of the entire Command Prompt window

LICENSE SERVER ADMINISTRATION TOOLS

Two license server administrative tools are provided for managing the licenser server administration tasks and monitoring the network license usage

The RLM Web Server (the preferred method)

The RLM web server is an embedded web server that has a web-based interface A web browser is required to use the web server The web server can be viewed and administered from any platform on your local network After the license server has started point your browser to httpServerHostNamePortNumber

For example httprwserver5054

By default the web server is started automatically on port 5054 when the RiverWare license server is started If you specified the argument -ws when you executed the rlm command then enter the port number you specified

Center for Advanced Decision Support for Water and Environmental Systems

Page 4 of 13

OR rlm ndashc Crwlicservercadsweslic ndashdlog Crwlicserverdebuglog ndashws 6003 (Run the web server on port 6003 instead of default 5054)

where -c

Specifies the location of the license file cadsweslic The file name should be entered with the full directory path included

-dlog Specifies the location of the file for RLM generated debug log The file name should be entered with the full directory path included Note that name debuglog is just a sample you can name it to anything you prefer

-ws Optional Specifies the port for the web server where is the desired port number The default is 5054 (The web server is the license server administration tool that is described later in this document)

IMPORTANT NOTES The license server will be shut down if you close the Command Prompt window that started the license server To keep the license server up and running all the time install the license server as a Windows service process Refer to later section ldquoRunning RiverWare License Server as a Windows Servicerdquo for more details

To verify RiverWare license server has started successfully check the following

o Start a Windows Task Manager Find rlmexe and cadswesexe processes running on the machine o View the debuglog file It can also be accessed through the RLM web server by selecting the ldquoSHOW rlm

Debug Logrdquo from the Status window The contents of the log file should look similar to the following (where lthostnamegt is the name of the license server machine and ltmacaddgt is the MAC address of the licenser server machine) 0419 1131 (rlm) RLM License Server Version 120BL2-p2 Copyright (C) 2006-2015 Reprise Software Inc All rights reserved 0419 1131 (rlm) License server started on danshuei 0419 1131 (rlm) Server architecture x64_w3 0419 1131 (rlm) License files 0419 1131 (rlm) Crwlicservercadsweslic 0419 1131 (rlm) 0419 1131 (rlm) Using options file rlmopt 0419 1131 (rlm) Web server starting on port 5054 0419 1131 (rlm) Using TCPIP port 5053 0419 1131 (rlm) adding UDPIP port 5053 0419 1131 (rlm) Starting ISV server cadswes on port 65182 0419 1131 (rlm) New thread created to watch ISV cadswes 0419 1131 (cadswes) RLM License Server Version 120BL2-p2 for ISV cadswes 0419 1131 (cadswes) Settings from RLM Version 120BL2 for ISV cadswes 0419 1131 (cadswes) Server architecture x64_w3 Copyright (C) 2006-2015 Reprise Software Inc All rights reserved RLM contains software developed by the OpenSSL Project for use in the OpenSSL Toolkit (httpwwwopensslorg)

Center for Advanced Decision Support for Water and Environmental Systems

Page 5 of 13

Copyright (c) 1998-2008 The OpenSSL Project All rights reserved Copyright (c) 1995-1998 Eric Young (eaycryptsoftcom) All rights reserved 0419 1131 (cadswes) 0419 1131 (cadswes) Server started on danshuei (hostid 180373ae77cf) for 0419 1131 (cadswes) riverware rlm_roam 0419 1131 (cadswes) 0419 1131 (cadswes) License files 0419 1131 (cadswes) Crwlicservercadsweslic 0419 1131 (cadswes)

ACCESSING LICENSE SERVER FROM A CLIENT MACHINE

For RiverWare to find a license server license file cadsweslic needs to be in the parent directory (ie one level up) from where RiverWare is installed This is the default location for RiverWare to search for a license file For example If RiverWare 70 is installed in CcadswesRiverWare 70

then your cadsweslic should be at Ccadswescadsweslic

o This cadsweslic can be the entire copy of the original cadsweslic file or a file that contains only the HOST line from the original cadsweslic file The HOST line lists information for the host name the host ID and the port number (if it is specified in the license file)

o License file cadsweslic must be saved in plain ASCII text file format Do not save it in Word format Rich text format or any other similar encoding

o It is recommended that users preserve the file name Do not make any changes to the saved cadsweslic file

o Make sure that there are no other files that have a file name extension of lic exist in the same directory where cadsweslic file is located

After RiverWare has started successfully the user can find out where RiverWare obtained the license by doing the following o In RiverWare Workspace window click Help gt About RiverWare o The section ldquoLicense Informationrdquo displays the version of the license manager and the license file used

when starting RiverWare

Center for Advanced Decision Support for Water and Environmental Systems

Page 6 of 13

If RiverWare encounters any problem when trying to access a license file a Command Prompt window will

appear and display an error message Email the error to RiverWare Install Support at installsupportcoloradoedu The error message can be obtained in one of the following two ways o The error output file

The location of it is displayed in the Command Prompt window after the line This message has been written to the file

o The screen shot of the entire Command Prompt window

LICENSE SERVER ADMINISTRATION TOOLS

Two license server administrative tools are provided for managing the licenser server administration tasks and monitoring the network license usage

The RLM Web Server (the preferred method)

The RLM web server is an embedded web server that has a web-based interface A web browser is required to use the web server The web server can be viewed and administered from any platform on your local network After the license server has started point your browser to httpServerHostNamePortNumber

For example httprwserver5054

By default the web server is started automatically on port 5054 when the RiverWare license server is started If you specified the argument -ws when you executed the rlm command then enter the port number you specified

Center for Advanced Decision Support for Water and Environmental Systems

Page 5 of 13

Copyright (c) 1998-2008 The OpenSSL Project All rights reserved Copyright (c) 1995-1998 Eric Young (eaycryptsoftcom) All rights reserved 0419 1131 (cadswes) 0419 1131 (cadswes) Server started on danshuei (hostid 180373ae77cf) for 0419 1131 (cadswes) riverware rlm_roam 0419 1131 (cadswes) 0419 1131 (cadswes) License files 0419 1131 (cadswes) Crwlicservercadsweslic 0419 1131 (cadswes)

ACCESSING LICENSE SERVER FROM A CLIENT MACHINE

For RiverWare to find a license server license file cadsweslic needs to be in the parent directory (ie one level up) from where RiverWare is installed This is the default location for RiverWare to search for a license file For example If RiverWare 70 is installed in CcadswesRiverWare 70

then your cadsweslic should be at Ccadswescadsweslic

o This cadsweslic can be the entire copy of the original cadsweslic file or a file that contains only the HOST line from the original cadsweslic file The HOST line lists information for the host name the host ID and the port number (if it is specified in the license file)

o License file cadsweslic must be saved in plain ASCII text file format Do not save it in Word format Rich text format or any other similar encoding

o It is recommended that users preserve the file name Do not make any changes to the saved cadsweslic file

o Make sure that there are no other files that have a file name extension of lic exist in the same directory where cadsweslic file is located

After RiverWare has started successfully the user can find out where RiverWare obtained the license by doing the following o In RiverWare Workspace window click Help gt About RiverWare o The section ldquoLicense Informationrdquo displays the version of the license manager and the license file used

when starting RiverWare

Center for Advanced Decision Support for Water and Environmental Systems

Page 6 of 13

If RiverWare encounters any problem when trying to access a license file a Command Prompt window will

appear and display an error message Email the error to RiverWare Install Support at installsupportcoloradoedu The error message can be obtained in one of the following two ways o The error output file

The location of it is displayed in the Command Prompt window after the line This message has been written to the file

o The screen shot of the entire Command Prompt window

LICENSE SERVER ADMINISTRATION TOOLS

Two license server administrative tools are provided for managing the licenser server administration tasks and monitoring the network license usage

The RLM Web Server (the preferred method)

The RLM web server is an embedded web server that has a web-based interface A web browser is required to use the web server The web server can be viewed and administered from any platform on your local network After the license server has started point your browser to httpServerHostNamePortNumber

For example httprwserver5054

By default the web server is started automatically on port 5054 when the RiverWare license server is started If you specified the argument -ws when you executed the rlm command then enter the port number you specified

Center for Advanced Decision Support for Water and Environmental Systems

Page 6 of 13

If RiverWare encounters any problem when trying to access a license file a Command Prompt window will

appear and display an error message Email the error to RiverWare Install Support at installsupportcoloradoedu The error message can be obtained in one of the following two ways o The error output file

The location of it is displayed in the Command Prompt window after the line This message has been written to the file

o The screen shot of the entire Command Prompt window

LICENSE SERVER ADMINISTRATION TOOLS

Two license server administrative tools are provided for managing the licenser server administration tasks and monitoring the network license usage

The RLM Web Server (the preferred method)

The RLM web server is an embedded web server that has a web-based interface A web browser is required to use the web server The web server can be viewed and administered from any platform on your local network After the license server has started point your browser to httpServerHostNamePortNumber

For example httprwserver5054

By default the web server is started automatically on port 5054 when the RiverWare license server is started If you specified the argument -ws when you executed the rlm command then enter the port number you specified

Center for Advanced Decision Support for Water and Environmental Systems

Page 7 of 13

The following displays the front page when you first started the RLM web server

To view the current status of license server and license usage select ldquoStatus from the menu on the left You will get a view titled ldquoStatus for ldquorlmrdquo on lthostnamegt (port )rdquo This screen displays all of the active RLM license servers on the system

Center for Advanced Decision Support for Water and Environmental Systems

Page 8 of 13

Click on the ldquocadswesrdquo button under the Server Status A view of ldquoISV cadswes status on lthostnamegt (port )rdquo displays the overall cadswes license server status on the system From the License Pool Status click on the ldquousagehelliprdquo under the Show Usage to view who has checked out a license on which host when the license was checked out etc

Center for Advanced Decision Support for Water and Environmental Systems

Page 9 of 13

For more detailed instructions of how to use the web server interface refer to chapter The RLM Web Server in the RLM License Administration Manual at httpwwwreprisesoftwarecomadminsoftware-licensingphp

Command-line Tools

Several command-line administration tools are provided as a convenience for use in administration scripts and programs Email installsupportcoloradoedu for further information

Center for Advanced Decision Support for Water and Environmental Systems

Page 8 of 13

Click on the ldquocadswesrdquo button under the Server Status A view of ldquoISV cadswes status on lthostnamegt (port )rdquo displays the overall cadswes license server status on the system From the License Pool Status click on the ldquousagehelliprdquo under the Show Usage to view who has checked out a license on which host when the license was checked out etc

Center for Advanced Decision Support for Water and Environmental Systems

Page 9 of 13

For more detailed instructions of how to use the web server interface refer to chapter The RLM Web Server in the RLM License Administration Manual at httpwwwreprisesoftwarecomadminsoftware-licensingphp

Command-line Tools

Several command-line administration tools are provided as a convenience for use in administration scripts and programs Email installsupportcoloradoedu for further information

Center for Advanced Decision Support for Water and Environmental Systems

Page 9 of 13

For more detailed instructions of how to use the web server interface refer to chapter The RLM Web Server in the RLM License Administration Manual at httpwwwreprisesoftwarecomadminsoftware-licensingphp

Command-line Tools

Several command-line administration tools are provided as a convenience for use in administration scripts and programs Email installsupportcoloradoedu for further information

Center for Advanced Decision Support for Water and Environmental Systems

Page 10 of 13

SHUTTING DOWN THE LICENSE SERVER

Shutting down the RiverWare license server can be done in the RLM web server interface or in a Command Prompt window Shutting down the RLM license server (rlmexe) must be done from a Command Prompt window

Using the RLM Web Server Interface

Select Shutdown from the menu on the left or from the Shutdown column in the ISV server status display You will see the ldquoShutdown License Serverrdquo screen below in the view area Select cadswes in the ISV name box to shut down the cadswes server If you leave the ISV name blank or enter all all other ISV servers will also be shut down The shutdown will happen when you click the SHUT DOWN SERVER button After the cadswes license server is shut down the status for the cadswes server in the Status view window will show ldquoServer Downrdquo Note that you cannot shut down the rlm license server from the shutdown screen To shut down the rlm license server use the command line tool rlmutil rlmdown as described in the next section

Using the Command Line

Open a Command Prompt window and change the current directory to the RiverWare license server folder where the active license server was started

The following command shuts down only the cadswes server not the rlm license server

rlmutil rlmdown cadswes

The following command shuts down the rlm license server (and the cadswes server if it is still running) Note that RLM must be in capital letters

rlmutil rlmdown RLM

The following command shuts down both rlm license server and the cadswes server Note that RLM must be in capital letters

rlmutil rlmdown cadswes RLM

RUNNING LICENSE SERVER AS A WINDOWS SERVICE

RLM license server can be installed and run as a Windows service process The process starts automatically at boot time and remains running as long as the system is up

The system administrator privileges are required to install the service

Installing RLM as a service can only be done in a Command Prompt window

Installing RLM as a service does not start the RLM license server The service is started via the Windows Services control panel manually and at boot time

Deleting RLM service is done in a Command Prompt window The service must be stopped first via the Windows Service Control panel before it can be deleted

Deleting RLM service only deletes it from the Windows service database it does not delete the RLM executable or associated license file(s)

Because the Service Controller on Windows invokes services under a special user account in a special default directory it is necessary to use full paths whenever a file path needs to be provided for configuring

Center for Advanced Decision Support for Water and Environmental Systems

Page 11 of 13

the service

Installing RLM Service

Open a Command Prompt window and change to the directory where all the license server program files and the license file cadsweslic are located Execute the following command

rlm -install_service [-service_name ltnamegt] [-c ltcadsweslicgt] [-dlog lt+rwlicserviceloggt]

For example (all in one single command line) rlm ndashinstall_service ndashservice_name RiverWareLicenseService ndashc Crwlicservercadsweslic ndashdlog Crwlicserverrwlicservicelogrdquo

where -service_name

An optional name for the installed service If not specified it is defaulted to rlm If the name contains embedded whitespace it must be enclosed in double quotes We strongly recommend specifying a unique name to identify the RiverWare license server

-c Specify the full path to the cadsweslic license file If the path contains embedded whitespace it must be enclosed in double quotes

-dlog Specify the full path to the server debug log file This parameter is required The preceded + character indicates the log file will be appended rather than created If the path or the name contains embedded whitespace it must be enclosed in double quotes

StartingStopping RLM Service

To start or stop an installed RLM service click Start gt Control Panel gt Administrative Tools gt Services Select the name of the installed RiverWare license service from the list (eg RiverWareLicenseService) o Select ldquoStart the servicerdquo to start the RLM license server o Select ldquoStop the servicerdquo to stop the RLM license server

Deleting RLM Service

Open a Command Prompt window and change to the directory where all the license server program files and the license file cadsweslic were used to started the service Execute the following command rlm -delete_service [-service_name ltnamegt]

For example rlm ndashdelete_service ndashservice_name RiverWareLicenseService

where -service_name

Specify the name of the installed service

Center for Advanced Decision Support for Water and Environmental Systems

Page 12 of 13

TROUBLESHOOTING

If RiverWare encounters a problem when trying to start a Command Prompt window will appear and display an error message Email the entire error message to installsupportcoloradoedu in one of the following two ways

Send the error output file The location of it is displayed in the Command Prompt window after the line This message has been written to the file

Send the screen shot of the entire Command Prompt window Following are some of the common errors when starting RiverWare on a client machine

Error _ERROR_ Acquiring the RiverWare license failed tried 2 licenses _ERROR_ LICENSE MANAGER Reprise 120 FEATURE riverware _ERROR_ Communications error with license server (-17) _ERROR_ LICENSE MANAGER Reprise 120 FEATURE riverwareviewer _ERROR_ Communications error with license server (-17)

Cause RiverWare cannot communicate with the license server This normally indicates the license server is not running Solution Start the license server on the network

Error _ERROR_ Acquiring the RiverWare license failed tried 2 licenses _ERROR_ LICENSE MANAGER Reprise 120 FEATURE riverware _ERROR_ All licenses in use (-22) _ERROR_ LICENSE MANAGER Reprise 120 FEATURE riverwareviewer _ERROR_ License server does not support this product (-18)

Cause The total available network floating licenses have already reached the limit The number of allowed RiverWare licenses is specified in the license file cadsweslic Solution One of the active RiverWare licenses has to stop (return the license to the license pool) before another license can be checked out

Error _ERROR_ Acquiring the RiverWare license failed tried 2 licenses _ERROR_ LICENSE MANAGER Reprise 120 FEATURE riverware _ERROR_ Canrsquot read license data (-102)No such file or directory (errno 2) _ERROR_ LICENSE MANAGER Reprise 120 FEATURE riverwareviewer _ERROR_ Canrsquot read license data (-102)No such file or directory (errno 2)

Cause RiverWare cannot find the license file from the default license location Solution

Center for Advanced Decision Support for Water and Environmental Systems

Page 13 of 13

RiverWare license file cadsweslic must be saved in the parent directory (ie one level up) from where RiverWare is installed For example if RiverWare 70 is installed in CCADSWESRiverWare 70 folder (the folder that holds the riverwareexe file) then your cadsweslic needs to be at CCADSWEScadsweslic

Error _ERROR_ Acquiring the RiverWare license failed tried 2 licenses _ERROR_ LICENSE MANAGER Reprise 120 FEATURE riverware _ERROR_ Bad server hostname in license file or porthost (-43) _ERROR_ LICENSE MANAGER Reprise 120 FEATURE riverwareviewer _ERROR_ Bad server hostname in license file or porthost (-43)

Cause The host name of the license server cannot be resolved by the name server This normally indicates that the client machine cannot connect to the license server Solution Contact your network system administrator

Error License server does not support this product (-18)

Cause RiverWare cannot connect to a valid license server This normally indicates the license server is not serving a valid license for running RiverWare For example the license has expired already Solution Start the license server on the network with a valid floating license

CONTACT RIVERWARE LICENSEINSTALLATION SUPPORT

To contact RiverWare license and installation support email the following

installsupportcoloradoedu

Center for Advanced Decision Support for Water and Environmental Systems

Page 11 of 13

the service

Installing RLM Service

Open a Command Prompt window and change to the directory where all the license server program files and the license file cadsweslic are located Execute the following command

rlm -install_service [-service_name ltnamegt] [-c ltcadsweslicgt] [-dlog lt+rwlicserviceloggt]

For example (all in one single command line) rlm ndashinstall_service ndashservice_name RiverWareLicenseService ndashc Crwlicservercadsweslic ndashdlog Crwlicserverrwlicservicelogrdquo

where -service_name

An optional name for the installed service If not specified it is defaulted to rlm If the name contains embedded whitespace it must be enclosed in double quotes We strongly recommend specifying a unique name to identify the RiverWare license server

-c Specify the full path to the cadsweslic license file If the path contains embedded whitespace it must be enclosed in double quotes

-dlog Specify the full path to the server debug log file This parameter is required The preceded + character indicates the log file will be appended rather than created If the path or the name contains embedded whitespace it must be enclosed in double quotes

StartingStopping RLM Service

To start or stop an installed RLM service click Start gt Control Panel gt Administrative Tools gt Services Select the name of the installed RiverWare license service from the list (eg RiverWareLicenseService) o Select ldquoStart the servicerdquo to start the RLM license server o Select ldquoStop the servicerdquo to stop the RLM license server

Deleting RLM Service

Open a Command Prompt window and change to the directory where all the license server program files and the license file cadsweslic were used to started the service Execute the following command rlm -delete_service [-service_name ltnamegt]

For example rlm ndashdelete_service ndashservice_name RiverWareLicenseService

where -service_name

Specify the name of the installed service

Center for Advanced Decision Support for Water and Environmental Systems

Page 12 of 13

TROUBLESHOOTING

If RiverWare encounters a problem when trying to start a Command Prompt window will appear and display an error message Email the entire error message to installsupportcoloradoedu in one of the following two ways

Send the error output file The location of it is displayed in the Command Prompt window after the line This message has been written to the file

Send the screen shot of the entire Command Prompt window Following are some of the common errors when starting RiverWare on a client machine

Error _ERROR_ Acquiring the RiverWare license failed tried 2 licenses _ERROR_ LICENSE MANAGER Reprise 120 FEATURE riverware _ERROR_ Communications error with license server (-17) _ERROR_ LICENSE MANAGER Reprise 120 FEATURE riverwareviewer _ERROR_ Communications error with license server (-17)

Cause RiverWare cannot communicate with the license server This normally indicates the license server is not running Solution Start the license server on the network

Error _ERROR_ Acquiring the RiverWare license failed tried 2 licenses _ERROR_ LICENSE MANAGER Reprise 120 FEATURE riverware _ERROR_ All licenses in use (-22) _ERROR_ LICENSE MANAGER Reprise 120 FEATURE riverwareviewer _ERROR_ License server does not support this product (-18)

Cause The total available network floating licenses have already reached the limit The number of allowed RiverWare licenses is specified in the license file cadsweslic Solution One of the active RiverWare licenses has to stop (return the license to the license pool) before another license can be checked out

Error _ERROR_ Acquiring the RiverWare license failed tried 2 licenses _ERROR_ LICENSE MANAGER Reprise 120 FEATURE riverware _ERROR_ Canrsquot read license data (-102)No such file or directory (errno 2) _ERROR_ LICENSE MANAGER Reprise 120 FEATURE riverwareviewer _ERROR_ Canrsquot read license data (-102)No such file or directory (errno 2)

Cause RiverWare cannot find the license file from the default license location Solution

Center for Advanced Decision Support for Water and Environmental Systems

Page 13 of 13

RiverWare license file cadsweslic must be saved in the parent directory (ie one level up) from where RiverWare is installed For example if RiverWare 70 is installed in CCADSWESRiverWare 70 folder (the folder that holds the riverwareexe file) then your cadsweslic needs to be at CCADSWEScadsweslic

Error _ERROR_ Acquiring the RiverWare license failed tried 2 licenses _ERROR_ LICENSE MANAGER Reprise 120 FEATURE riverware _ERROR_ Bad server hostname in license file or porthost (-43) _ERROR_ LICENSE MANAGER Reprise 120 FEATURE riverwareviewer _ERROR_ Bad server hostname in license file or porthost (-43)

Cause The host name of the license server cannot be resolved by the name server This normally indicates that the client machine cannot connect to the license server Solution Contact your network system administrator

Error License server does not support this product (-18)

Cause RiverWare cannot connect to a valid license server This normally indicates the license server is not serving a valid license for running RiverWare For example the license has expired already Solution Start the license server on the network with a valid floating license

CONTACT RIVERWARE LICENSEINSTALLATION SUPPORT

To contact RiverWare license and installation support email the following

installsupportcoloradoedu

Center for Advanced Decision Support for Water and Environmental Systems

Page 12 of 13

TROUBLESHOOTING

If RiverWare encounters a problem when trying to start a Command Prompt window will appear and display an error message Email the entire error message to installsupportcoloradoedu in one of the following two ways

Send the error output file The location of it is displayed in the Command Prompt window after the line This message has been written to the file

Send the screen shot of the entire Command Prompt window Following are some of the common errors when starting RiverWare on a client machine

Error _ERROR_ Acquiring the RiverWare license failed tried 2 licenses _ERROR_ LICENSE MANAGER Reprise 120 FEATURE riverware _ERROR_ Communications error with license server (-17) _ERROR_ LICENSE MANAGER Reprise 120 FEATURE riverwareviewer _ERROR_ Communications error with license server (-17)

Cause RiverWare cannot communicate with the license server This normally indicates the license server is not running Solution Start the license server on the network

Error _ERROR_ Acquiring the RiverWare license failed tried 2 licenses _ERROR_ LICENSE MANAGER Reprise 120 FEATURE riverware _ERROR_ All licenses in use (-22) _ERROR_ LICENSE MANAGER Reprise 120 FEATURE riverwareviewer _ERROR_ License server does not support this product (-18)

Cause The total available network floating licenses have already reached the limit The number of allowed RiverWare licenses is specified in the license file cadsweslic Solution One of the active RiverWare licenses has to stop (return the license to the license pool) before another license can be checked out

Error _ERROR_ Acquiring the RiverWare license failed tried 2 licenses _ERROR_ LICENSE MANAGER Reprise 120 FEATURE riverware _ERROR_ Canrsquot read license data (-102)No such file or directory (errno 2) _ERROR_ LICENSE MANAGER Reprise 120 FEATURE riverwareviewer _ERROR_ Canrsquot read license data (-102)No such file or directory (errno 2)

Cause RiverWare cannot find the license file from the default license location Solution

Center for Advanced Decision Support for Water and Environmental Systems

Page 13 of 13

RiverWare license file cadsweslic must be saved in the parent directory (ie one level up) from where RiverWare is installed For example if RiverWare 70 is installed in CCADSWESRiverWare 70 folder (the folder that holds the riverwareexe file) then your cadsweslic needs to be at CCADSWEScadsweslic

Error _ERROR_ Acquiring the RiverWare license failed tried 2 licenses _ERROR_ LICENSE MANAGER Reprise 120 FEATURE riverware _ERROR_ Bad server hostname in license file or porthost (-43) _ERROR_ LICENSE MANAGER Reprise 120 FEATURE riverwareviewer _ERROR_ Bad server hostname in license file or porthost (-43)

Cause The host name of the license server cannot be resolved by the name server This normally indicates that the client machine cannot connect to the license server Solution Contact your network system administrator

Error License server does not support this product (-18)

Cause RiverWare cannot connect to a valid license server This normally indicates the license server is not serving a valid license for running RiverWare For example the license has expired already Solution Start the license server on the network with a valid floating license

CONTACT RIVERWARE LICENSEINSTALLATION SUPPORT

To contact RiverWare license and installation support email the following

installsupportcoloradoedu

Center for Advanced Decision Support for Water and Environmental Systems

Page 13 of 13

RiverWare license file cadsweslic must be saved in the parent directory (ie one level up) from where RiverWare is installed For example if RiverWare 70 is installed in CCADSWESRiverWare 70 folder (the folder that holds the riverwareexe file) then your cadsweslic needs to be at CCADSWEScadsweslic

Error _ERROR_ Acquiring the RiverWare license failed tried 2 licenses _ERROR_ LICENSE MANAGER Reprise 120 FEATURE riverware _ERROR_ Bad server hostname in license file or porthost (-43) _ERROR_ LICENSE MANAGER Reprise 120 FEATURE riverwareviewer _ERROR_ Bad server hostname in license file or porthost (-43)

Cause The host name of the license server cannot be resolved by the name server This normally indicates that the client machine cannot connect to the license server Solution Contact your network system administrator

Error License server does not support this product (-18)

Cause RiverWare cannot connect to a valid license server This normally indicates the license server is not serving a valid license for running RiverWare For example the license has expired already Solution Start the license server on the network with a valid floating license

CONTACT RIVERWARE LICENSEINSTALLATION SUPPORT

To contact RiverWare license and installation support email the following

installsupportcoloradoedu