License Proxy - IP Forwarding
A step-by-step guide for Rescale customers to setup a license proxy using IP forwarding mode on Rescale admin page
IP forwarding mode is a method that involves relocation of address and/or port numbers of a packet and sending it to a new destination. IP forwarding method is quick and easy to set up. It is a self service solution when configured requires no on-going maintenance. This is the simplest configuration that allows you to run batch jobs and desktops using Rescale to access your on-premise licenses.
- The user should be an IT/Network admin in the company and should have access to make changes on the gateway device/firewall rules.
- The user should have an account on Rescale
- The user should be a company administrator (in Rescale). To become a company administrator, please email a request to firstname.lastname@example.org
- The user should have admin privileges to the on-premises license server. Ideally, this is the IT admin of the company who manages the on-premises license server
- The public IP address of your internal network.
- Hostname for on-premise license server
- List of software and associated license and vendor ports (If any)
- Ensure that the vendor port is fixed in license file before starting with the license proxy setup, for all the softwares using FlexLM and RLM license services (e.g ANSYS, STAR-CCM+,Converge, Comsol, etc.) How to Fix Vendor Port
Obtain Information, Update Ports and Restart On-Premises License Server
This section lists the steps on how to extract the port and hostname information required for the license proxy setup. These information can be extracted from the license file and the associated license logs on the on-premise license server machine hosting the licenses
Obtain Port (License and Vendor) Information
The port (license and the vendor) information can be obtained from the license file and the associated license logs
For both FlexLM and RLM there are 2 processes that handle license access: the License Server (lmgrd or rlm) and the Vendor Daemon
FlexLM (e.g ANSYS, STAR-CCM+, COMSOL etc.)
- For applications using FlexLM license service (ansyslmd, cdlmd, etc.) , the license port can be found from the license file. Open the license file (e.g license.dat or license.lic) and look at the "SERVER" line for the license port that the license is being hosted on.
- For the vendor port you can confirm this from the "VENDOR" line of the license file or from the license logs. For e.g, in case of "ANSYS" you can open the ansyslmd.log (on the on-premise license server machine hosting the licenses) file and look at the part of the log where it says something like:
00:00:00 (lmgrd) FlexNet Licensing (<license manager version>) started on <hostname> 00:00:00 (lmgrd) lmgrd tcp-port <license server port> 00:00:00 (lmgrd) Started <vendor daemon> (pid <pid>) 00:00:00 (lmgrd) <vendor daemon> using TCP-port <vendor port>
RLM (e.g Converge, MixIT etc.)
- For applications using Reprise License Manager (RLM), the license port information can be obtained from the "HOST" line of the license file and the associated license log (from the on-premise license server machine hosting the licenses).
- For the vendor port information you can confirm this from the "ISV" line of the license file or open the associated license logs. For e.g, in case of "Converge" you can open the converge.log (on the on-premise license server machine hosting the licenses) file and look at the part of log where it says something like this:
1/1 00:00 (rlm) License server started on <hostname> 1/1 00:00 (rlm) Using TCP/IP port <license server port> 1/1 00:00 (rlm) Starting ISV server <vendor daemon> on port <vendor port>
Some of the Examples of Default Port Numbers used for Softwares
FLEXLM (Flexera License Manager)
ANSYS - ANSYS uses default license ports as 1055 and 2325 . You can confirm if the license port is indeed 1055 or some other port number from the "SERVER" line of the license file and vendor daemon port that can be set in the license file in the "VENDOR" line. You can choose any port that is available on your end and not being used by any other application and fix it in the license file.
STAR-CCM+ - STAR-CCM+ uses default port as 1999 . You can confirm if the license port is 1999 from the "SERVER" line of the license file and can choose any port for the vendor daemon port that is available on your end and not being used by any other application and fix it in the license file in the "VENDOR" line.
ABAQUS - ABAQUS uses default port 27000. You can confirm if the license port is 27000 from the "SERVER" line of the license file and can choose any port for the vendor daemon port that is available on your end and not being used by any other application and fix it in the license file in the "VENDOR" line.
COMSOL - COMSOL uses default port 1718. You can confirm if the license port is 1718 from the "SERVER" line of the license file and can choose any port for the vendor daemon port that is available on your end and not being used by any other application and fix it in the license file in the "VENDOR" line.
RLM (Reprise License Manager)
- Converge - Converge uses default port 2765. You can confirm if the license port is 2765 from the "HOST" line of the license file and can choose any port for the vendor daemon port that is available on your end and not being used by any other application and fix it in the license file in the "ISV" line.
LSTC (Livermore Software Technologies)
- LS-DYNA - LS-DYNA uses a single license port and does not use any vendor port. The default license port used by LS-DYNA is 31010. You can confirm this from the license file.
Update Vendor Ports
How to fix the vendor port in the license file?
Here is how you can fix the vendor port in the license file: How to Fix Vendor Port
If the vendor port is not fixed in the license file, each time the the server is restarted the vendor port(s) might change and to avoid such situation it is recommended to make the vendor port static in the license file for any license softwares that use vendor daemon port (FlexLM and RLM etc.).
Before making any changes to the vendor port(s), make sure you temporarily shutdown the on-premise license server machine or the license manager and make sure there are no running jobs making use of the licenses
Once the changes are made in the license file to make the vendor port static, in order to apply the changes, the license server machine or the license manager should be restarted
This can be confirmed from the associated license logs. In case of ANSYS or STAR-CCM+ you can verify this from ansyslmd.log or cdlmd.log file respectively.
For applications using Reprise License Manager (RLM) such as Converge, this can be verified from the converge.log file and verify if the vendor port is correctly updated
License Proxy Settings on Rescale Company Admin Page
This section lists the steps to setup license proxy using IP forwarding mode on Rescale Admin page. The license proxy setup on the Company Administration Page can be accessed at license proxy page
- Navigate to the Rescale Admin page from your account to start the setup for the license proxy
- Navigate to Integrations>>License Proxies
- Select Add New
- The page will look similar like the screenshot below:
Give a Unique Name for the license proxy
Select IP Forwarding mode as the license proxy mode
Now, add the IP Address, Hostname and Port Information (License and Vendor Port) in the "License Hosts" section.
Set the IP Address. This is the Public IP address of the on-premise license server where you want to forward the traffic to. This is ideally the public IP of your gateway/router/network device.
Enter the resolvable Hostname of your on-premise license server machine. This is the hostname of the on-premise license server machine that hosts the software application licenses. The hostname can be obtained from the license file.
Here is how to find the hostname of the license server machine:
- FLEXLM - For all the software applications that use FLEXLM (Flexera) type of license service such as, ANSYS, STAR-CCM+, ABAQUS, COMSOL etc., you can find the hostname from the "SERVER" line of the license file.
- RLM - For all the software applications using Reprise License Manager (RLM) type of license service such as, Converge, MixIT etc., you can find the hostname from the "HOST" line of the license file.
Select the software that you want to configure the license proxy for from the "Software(s) dropdown. Please choose all the softwares that you want to configure in the software section. For example if you are using COMSOL Multiphysics in batch as well as COMSOL Multiphysics GUI in a Rescale Desktop, then you should choose both COMSOL Multiphysics as well as COMSOL Multiphysics GUI in the software entry.
Set the License Port. This port is the port that the job refers to while checking out license. This is the license port that is being used by the application on-premise on your license server machine.
Enter the Vendor Port . This is the vendor daemon port that is being used by this software application.
This port is required for applications using FlexLM or RLM type of license service such as ANSYS, STAR-CCM+, ABAQUS, COMSOL etc.
For application such as LS-DYNA that uses LSTC or Dynamore license service, the vendor port is not required and the "Vendor port" field can be left blank for LS-DYNA or any software that does not use a vendor daemon port.
- You can also use the small "Toggle Icon" on the bottom right corner in license hosts section for advanced settings as shown below:
- This setting can be used when you have multiple software applications being hosted on different machines on-premise but using the same port. In such case you can choose a different or unique "Proxy" port to map to each different on-premise machine for those applications and choose those softwares from the list of softwares
Specify Additional Ports
- This option can also be used if the application is using single license port but multiple vendor port (For e.g PowerFLOW) or multiple license port (For e.g ANSYS). You can choose "+ Specify an additional license port" option and add the multiple vendor ports or license port for the software as shown below:
Specify Another License Service
- If you have multiple license services being hosted on a single host, and if you want to connect additional license services to same host, then you can choose the "+ Specify another license service" option as shown below and add the required port information for the same:
Connect this Proxy to another License Host
- If you want to connect additional applications that are being hosted on-premise on a different license server which has a different hostname and IP, you can choose the "+Connect this proxy to another on-premise license host" option as shown below:
Once you are done with configuring all the details you can click on the Launch License Proxy button at the bottom of the license proxy page.
You will now see a screen with status like the one below:
- Once the proxy is launched, you will see a Status and Info section at the top of the license proxy page. The Status section indicates :
- Proxy: If the license proxy launch was successful or not. If that status shows as UP in "Green" that indicates that the proxy was launched properly.
- Last Sync: If the last changes that you saved were successfully saved or not. If that status shows as SUCCESSFUL in "Green" that indicates that the last sync was successfull.
- Connections: If there are acitve connections listening on that IP and port, this will show as ACTIVE in Green.
Note: If you see any of the Status in the status section in Yellow or Red that indicates that either the last sync was not successful or there are no active connections for the proxy. In such cases, please reach out to email@example.com
- Info - In this section you will see the public IP of the license proxy. This IP should be whitelisted on your internet gateway/firewall to allow inbound from the Rescale license proxy to the on-premise license server. This will allow the applications to checkout licenses when submitted on Rescale. If your on-premise gateway/firewall device does not have this IP (public IP of license proxy whitelisted) the jobs submitted on Rescale will not be able to checkout licenses.
- Once, all the settings are correctly configured on the license proxy settings page, you should then be able to run jobs, and checkout licenses successfully.
To test your connection and verify if the settings made were properly configured:
- Click on the "Check License Availability" button in the "License Hosts" section on the company license proxy page and that should give you all the license features along with the number of license seats you have available.
Please note the "Check License Availability" currently only displays the status for applications using FlexLM and Dynamore (LSTC) type of license services such as, ANSYS, STAR-CCM+, ABAQUS (Flex), LS-DYNA. If you have an RLM license software configured (such as Converge, MixIT etc.) or DSLS type of license service, the "Check License Availability" will not display any information.
- For FlexLM or RLM type of license service if the "Check License Availability" shows as "The license server is down or not responding", this means:
- That the public IP of the license proxy is not whitelisted on your gateway device to allow inbound traffic or
- The on-premise license server is not active or there is no active license process currently being served on your on-premise license server. Please check with your IT/Network or the license server admin team to check for the firewall settings or the license server status.
- Submit a dummy job by logging into your Rescale account
- Create a new job by clicking the +New job button in the top left of the page. Select the Software you want in the software section and select Use Existing License option as shown below:
- In the appropriate field type in port@hostname . For example if you have configured ANSYS software on the license proxy and your license port is 1055, then enter 1055@hostname then click "Check availability" button. The license prompt will provide you with immediate feedback for whether the license server address specified in the license settings is reachable from the Rescale platform by clicking the ”Check Availability” button. It will also display all the license features and the associated license seats available for your licenses.
Pro's and Con's of IP Forwarding Mode
- It is the simplest setup to access on-premise licenses
- It only needs the Rescale license proxy public IP address to be whitelisted on the customer gateway/firewall device
- Does not require maintenance
- It is a more robust solution because it doesn't rely on a tunnel being kept open
- It does not have any encryption