Floating License Guide

License Server Management Guide

This guide is designed for RLM v16.0. If you’d like to upgrade your RLM to v16.0, please read the upgrade guide.

This page explains how to check the status of your license usage and how to configure options to suit your specific use cases. For more details, please also refer to the official Reprise manual. The manual can be accessed from the [Documentation] menu on the RLM Web server.

View License’s Expiration Date

1. Start your web browser and open https://<Hostname>:5054.
   
2. Click [Home].
   
   
   
3. Click the arrow beside the [cvastah].
   
   
   
4. Your license information appears and you can check the expiration date for each license.
   
   
   

You can also see the license expiry date in CV Members.

View License Usage

1. Start your web browser and open https://<Hostname>:5054.
   
   
2. Click [Home].
   
   
   
3. It shows a list of managed licenses. Click the arrow to see the details of each license.
   
   
   
   
4. It opens up the detail of the selected license.
   
   

Release license off assigned users

You can remove users from the active-user list to make the license seat available for other users.

1. Open a License Usage list.
2. Click [Remove] button to get the person off the list.
   

Using RLM across a Firewall

RLM License Server uses two TCP Ports. One is 5053(default) and another is dynamic.
If you have a firewall installed on the network, the firewall will not allow access to these ports and a connection to the License Server from the clients will be blocked. So you need to change the port number by editing your license file. If you have several license files stored in the license sever, make the same change to all the license files.

When you open a license file, you will see the first two lines as below:

HOST ANY xxx.xxx.xxx.xxx 5053
ISV cvastah

The line starting with HOST is the configuration for the License Server. xxx.xxx.xxx.xxx shows the ID of the license server – you cannot change this ID. 5053 is a port number that the license server uses.

Another line starting with ISV is a configuration for the cvastah service, and it indicates that this works with a dynamic port. You can change both port numbers like examples as below:

Example) Changing the HOST Port to 5055 and ISV to 2385 on Windows

HOST ANY xxx.xxx.xxx.xxx 5055
ISV cvastah port=2385

You have to restart the license server after making the change. Also, make sure to configure your firewall to allow access to these ports you set.

SSL Certificate Configuration (v16.0 and later)

If the license server is v16.0 or later, SSL is required to access the RLM Web server. During the initial access, a self-signed SSL certificate is automatically configured, but if you want to use an SSL certificate issued by a private or official certification authority, specify the following execution options.

For Windows:

1. Open the register_service.bat file, which is included with the Windows version, in a text editor. Edit {path to SSL certificate} and {path to SSL private key} to match your environment.

2. Replace the following line:

rlm -ws %REPRISE_PORT% -dlog "%LOG_FILE%" -install_service -service_name
"%SERVICE_NAME%"

with

rlm -ws %REPRISE_PORT% -dlog "%LOG_FILE%" -install_service -service_name
"%SERVICE_NAME%" -sslcert {path to SSL certificate} -sslprivkey {path to SSL private key}

3. Run delete_service.bat to delete the service once.

4. Run the edited register_service.bat to re-register the service.

5. Restart the service and access the RLM Web Server via your browser.

6. Verify that the SSL certificate is configured as intended.

For Linux:

1. Open the license manager’s unit file.

2. Locate the line beginning with ExecStart and add -sslcert {path to SSL certificate} -sslprivkey {path to SSL private key}. Edit {path to SSL certificate} and {path to SSL private key} to match your environment.

3. Reload systemd:

systemctl daemon-reload

4. Restart the license manager:

systemctl restart rlm

5. Restart the service and access the RLM Web Server via your browser.

6. Verify that the SSL certificate is configured as intended.

Access Control (v16.0 and later)

If your license server is v16.0 or later, you can manage users who access the Web License Server. By setting user permissions, you can restrict the actions that users are allowed to perform.
For detailed information about permissions, please refer to the RLM manual.

Change your License Server Machine

1. Set up the RLM license server by following the instruction here on the new machine you plan to use.
   
2. Get the Host ID of the new machine by following the step here.
   
3. Login to CV Members
   
4. Go to [License Management]
   
   
   
5. Select [Change License Server] and click [Next].
   
   
   
6. Enter the Host ID and the reason for the server machine change.
   
   
   
7. Follow the instruction on the web page and email you will be receiving from us.

Uninstall the License Server

You can uninstall the License Server when you no longer need it.

Windows

1. Delete the service
2. Delete the RLM License Server Installation folder

Linux

1. Delete the daemon that launches the RLM License Server
2. Delete the directory where you installed the RLM License Server

Using the Options file

By modifying the options file “cvastah.opt“, you can customize how the License Server works to make it more useful for you. Here’re a few options that you may want to use. Also, make sure to restart the license server after you modify this option file.

Export License Usage Report

By adding REPORTLOG option, you can produce detailed report logs for the license activity.

Format

REPORTLOG [+]file_path [std | small | detailed] auth

By adding + to the beginning of the file path, the report log never overwrites the other even after restarting the license server.

Example) Export log to C:\astah\rlm\usage.log in std format. No overwriting.

REPORTLOG +C:¥astah¥rlm¥usage.log std auth

Also, you can use the ROTATE option to set the rotation of the log file.

Format

ROTATE [daily | weekly | montly | #days ]

Example: Set rotation as 30days

ROTATE 30

For more information about this REPORT LOG options, please refer to the RLM Manual.

Control Access

By adding INCLUDEALL option, you can control the access from the clients to the license server.

Format

INCLUDEALL [user|host|group|host_group|internet|
internet_group|project] who

Example: Grant privilege to John on pc1 with IP address 172.16.7.x

INCLUDEALL user john
INCLUDEALL host pc1
INCLUDEALL internet 172.16.7.

For more information about INCLUDEALL options, please refer to the RLM Manual.

Control Access per License

By adding INCLUDE or EXCLUDE option, you can control the access of the users per license.

1. Open a license file(.lic) and add the same ID of “options=_id=nnnn” as new to the LICENSE line.

Example: Adding id=00000001

LICENSE cvastah product 1.0 dd-mm-yyyy 10 share=uh _id=00000001
issued=21-nov-2018 options=_id=00000001 _ck=xxxx sig="xxxx"

2. Now modify the option file

Format

INCLUDE/EXCLUDE astah-professional user|host|
group|host_group|internet|internet_group|
project who id=nnn

e.g. Giving access by IP Address for Astah Pro’s license id=0000001

INCLUDE astah-professional internet 192.168.* id=00000001

e.g. Giving access by User Group for Astah Pro’s license id=0000001

GROUP engineers tom dick harry
INCLUDE astah-professional group engineers id=00000001

For more information about these options, please refer to the RLM Manual.

Stop Roaming

By adding the following line in the option file, you can stop anyone from roaming the license. You must restart the License Server after alerting to apply this change.

For Astah Professional

ROAM_MAX_COUNT 0 astah-professional

For Astah UML

ROAM_MAX_COUNT 0 astah-uml