User Tools

  • Vistasource Document Library

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
rtw_4.5:obtain_a_product_key [2013/03/20 16:06]
Philip Wittamore [FLEXlm license Server]
rtw_4.5:obtain_a_product_key [2018/08/04 20:09] (current)
Line 1: Line 1:
 ======Obtain a Product Key====== ======Obtain a Product Key======
  
-A product key (also called a license) allows you to operate RTW and RTSHARE ​ether permanently or for a set period of time.+A product key (also called a license) allows you to operate RTW and RTSHARE ​either ​permanently or for a set period of time.
  
 If you are interested in purchasing a permanent product key, please contact [[rtwsales@vistasource.com]] If you are interested in purchasing a permanent product key, please contact [[rtwsales@vistasource.com]]
Line 8: Line 8:
  
 |[[#​VSLIC]]|The Vistasource Online Licensing Tool| |[[#​VSLIC]]|The Vistasource Online Licensing Tool|
-|[[#Licensing using a Flexlm license server|FLEXlm License Server]]|For those wishing to run their own license server.\\ ​This can also be installed ​independantly, see [[rtw_4.5:installation]]|+|[[#FLEXlm License Server]]|For those wishing to run their own license server.\\ ​It can also be installed ​independently, see [[installation#​installing_the_flexlm_license_server|Installation]]|
  
-By default, upon installation RTW and RTSHARE ​use  ​[[#VSLIC]]+By default, upon installation ​of RTW and RTSHARE[[#​VSLIC]] ​is used.  
 + 
 +== See Also: == 
 +[[rtw_4.5:​Technical Specifications]]\\ 
 +[[rtw_4.5:​Software License Terms]]\\ 
 +\\ 
 +\\
  
  
Line 19: Line 25:
    
 ===== VSLIC ===== ===== VSLIC =====
 +
 +VSLIC is an online product key management tool for RTW and RTSHARE.
  
 ==== What is a VSID? ==== ==== What is a VSID? ====
  
-The Vistasource Online Licensing Tool "vslic.exe" allows easy management of your RTW & RTSHARE licenses by retrieving licenses via an internet connection using a unique identifier, or VSID. A single VSID can be used upon multiple machines, simplifying large scale deployment.+The Vistasource Online Licensing Tool "​vslic"​ allows easy management of your RTW & RTSHARE licenses by retrieving licenses via an internet connection using a unique identifier, or VSID. A single VSID can be used for multiple machines, simplifying large scale deployment.
  
 ==== Demonstration mode ==== ==== Demonstration mode ====
Line 34: Line 42:
 The Vistasource Online Licensing Tool can be accessed in three ways: The Vistasource Online Licensing Tool can be accessed in three ways:
  
-  * At the end of the installation,​ keep the default selection **Obtain permanent or evaluation license now**. ​ See [[#installation]] for more information.  +  * At the end of the installation,​ keep the default selection **Obtain permanent or evaluation license now**. ​ See [[#Installation]] for more information.  
-  * In Excel 2007 or 2010, click **License Management** on the Vistasource ribbon menu.  In Excel 2003, click **Vistasource -> License Management**. See [[#installation]] for more information.  +  * In Excel 2007 or 2010, click **License Management** on the Vistasource ribbon menu.  In Excel 2003, click **Vistasource -> License Management**. See [[#Installation]] for more information.  
-   * In the RTW application directory which by default is in Windows XP in //​C:​\Program Files\Vistasource\RTW\4.5//​ and in Windows 7 in //​C:​\Program Files (x86)\Vistasource\RTW\4.5//​ ). In Windows XP, click on the application named "vslic.exe"​. ​ In Windows 7, it is required to run vslic.exe as Administrator. To launch vslic.exe on Windows 7, right-click on the application named "vslic.exe" and select Run as Administrator. ​+   * In the RTW application directory which by default is in Windows XP in //​C:​\Program Files\Vistasource\RTW\4.5//​ and in Windows 7 in //​C:​\Program Files (x86)\Vistasource\RTW\4.5//​ ). In Windows XP, click on the application named "​vslic"​. ​ In Windows 7, it is required to run vslic as Administrator. To launch vslic on Windows 7, right-click on the application named "​vslic"​ and select ​**Run as Administrator**
  
 The dialog Vistasource Online Licensing Tool opens. The dialog Vistasource Online Licensing Tool opens.
  
-{{ :rtw_4.5:vslic_45.jpg |}}+{{ :rtw_4.5:vslic.png?​nolink ​|}}
  
  
-<​note>​Depending on the number of purchased licenses, a single ​VISD can be used to license RTW on many machines. ​Simply perform the steps as outlined below. ​The options Verify License and Verify VSID provide information about the licensed features and the scope of the VSID. </​note>​+<​note>​single ​VSID can cover product keys for multiple ​machines. ​\\ 
 +The options Verify License and Verify VSID provide information about the licensed features and the scope of the VSID. </​note>​
  
  
 ==== Installation ==== ==== Installation ====
  
-To License RTW during installation:​+To License RTW and RTSHARE ​during installation:​
  
   - At the end of the install process, keep the default selection **Obtain permanent or evaluation license now**. The dialog Vistasource Online Licensing Tool opens.   - At the end of the install process, keep the default selection **Obtain permanent or evaluation license now**. The dialog Vistasource Online Licensing Tool opens.
   - Three scenarios are possible: ​   - Three scenarios are possible: ​
-    - If you install for the first time, the VSID will be set to"​30DAYDEMO"​. The tool will attempt to generate a demo licenses. If a demo license has already been generated for the machine, vslic will error and invite you to contact [[rtwsales@vistasource.com]].+    - If you install for the first time, the VSID will be set to"​30DAYDEMO"​. The tool will attempt to generate a demonstration license. If a demonstration ​license has already been generated for the machine, vslic will error and invite you to contact [[rtwsales@vistasource.com]].
     - If you have obtained a permanent VSID, enter the alphanumeric code.      - If you have obtained a permanent VSID, enter the alphanumeric code. 
     - If you are a system administrator and installing multiple instances of the product with automatic license retrievals, see [[#​Options]] further down.     - If you are a system administrator and installing multiple instances of the product with automatic license retrievals, see [[#​Options]] further down.
   - Click **Get license**. ​  The status window displays a list of your license components together with a confirmation that RTW is correctly licensed. A license called "​vista.lic"​ will be installed in the application directory. ​   - Click **Get license**. ​  The status window displays a list of your license components together with a confirmation that RTW is correctly licensed. A license called "​vista.lic"​ will be installed in the application directory. ​
   - Click **Quit** to close the dialog.   - Click **Quit** to close the dialog.
-  - Restart Excel and RTW is ready for use.+  - Restart ​MS Excel and RTW is ready for use.
  
  
  
-====Post ​installation====+====Post ​Installation====
  
 To license RTW & RTSHARE after installation:​ To license RTW & RTSHARE after installation:​
  
-  - Click **License Management** in the Vistasource ribbon menu in Excel to open the Vistasource Online Licensing Tool dialog.+  - Click **License Management** in the Vistasource ribbon menu in MS Excel to open the Vistasource Online Licensing Tool dialog.
   - Enter your alphanumeric VSID, To obtain a permanent VSID, contact [[rtwsales@vistasource.com]]. ​   - Enter your alphanumeric VSID, To obtain a permanent VSID, contact [[rtwsales@vistasource.com]]. ​
   - Click **Get license**. ​  The status window displays a list of your license components together with a confirmation that RTW is correctly licensed. A license called "​vista.lic"​ will be installed in the application directory. ​   - Click **Get license**. ​  The status window displays a list of your license components together with a confirmation that RTW is correctly licensed. A license called "​vista.lic"​ will be installed in the application directory. ​
Line 75: Line 84:
 To verify your licensed comopents: To verify your licensed comopents:
  
-  - Click **License Management** in the Vistasource ribbon menu in Excel to open the Vistasource Online Licensing Tool dialog.+  - Click **License Management** in the Vistasource ribbon menu in MS Excel to open the Vistasource Online Licensing Tool dialog.
   - Click **Verify License**. The status field displays a list of your licensed RTW features, e.g which RTW engine is licensed. A status message provides information about the state of the license.   - Click **Verify License**. The status field displays a list of your licensed RTW features, e.g which RTW engine is licensed. A status message provides information about the state of the license.
   - Click **Quit** to close the dialog.   - Click **Quit** to close the dialog.
Line 93: Line 102:
 VSLIC can make a basic test to check the system and note any missing requirements:​ VSLIC can make a basic test to check the system and note any missing requirements:​
  
-  - Click **License Management** in the Vistasource ribbon menu in Excel to open the Vistasource Online Licensing Tool dialog. +  - Click **License Management** in the Vistasource ribbon menu in MS Excel to open the Vistasource Online Licensing Tool dialog. 
-  - Click **System Info**. The status field displays a list of information regarding your system including ​an RTW version ​check and installed Add-ins. ​+  - Click **System Info**. The status field displays a list of information regarding your system including ​a check for the  ​RTW version and installed ​RTW Add-ins. ​
   - Click **Quit** to close the dialog.   - Click **Quit** to close the dialog.
  
Line 106: Line 115:
 Upon successful renewal, click **Get license** in the Online Licensing Tool to activate the new expiration date. Restart Excel, and your license is valid for the duration according to the renewed leasing terms. ​ Upon successful renewal, click **Get license** in the Online Licensing Tool to activate the new expiration date. Restart Excel, and your license is valid for the duration according to the renewed leasing terms. ​
  
 +====Migration and Removal====
 +
 +A VSID can contain licenses for multiple machines. \\ 
 +If your VSID has an associated maintenance plan, [[installation#​uninstall|uninstalling RTW]] or [[installation#​uninstall1|RTSHARE]] will free the license for use on another machine.
  
 ====Options==== ====Options====
Line 116: Line 129:
 If these environment variables are set, the Online Licensing Tool will automatically generate the appropriate licenses upon installation. If these environment variables are set, the Online Licensing Tool will automatically generate the appropriate licenses upon installation.
  
-====Troubleshooting==== 
  
-In case problems arise, please check our [[rtw_4.5:​troubleshooting#​vslic_tips|troubleshooting section]]. 
  
- ​\\ ​+====Privacy====
  
 +VSLIC is non invasive. The only machine information transmitted online to our license server is the MAC address, Hostname, and Username.
 +We do not sell, trade of otherwise transfer this information to any outside parties.
  
 +====Troubleshooting====
  
-== See Also: == +In case problems arise, please check our [[rtw_4.5:troubleshooting#​vslic|troubleshooting section]].
-[[rtw_4.5:Technical Specifications]]\\ +
-[[rtw_4.5:Software License Term]]\\ +
-\\ +
-\\ +
-=====FLEXlm license Server =====+
  
-This product key management method supports many different solutions for managing licenses.+ ​\\ ​
  
  
  
 +===== FLEXlm License Server =====
  
 +The FLEXlm license server allows running a license server either on the same machine as RTW or RTSHARE, ​
 +\\ or [[installation#​flexlm_license_server|on a dedicated machine]]. For more details, see: 
  
  
 +  * [[#​how_to_get_license_keys|How to Get License Keys]] \\
 +  * [[#​setup_and_configuration|Setup and Configuration]] \\
 +  * [[#​setting_up_a_license_client|Setting up a License Client]]\\
 +  * [[#​remote_license_server|Remote License Server]]
  
-==== How to get license keys ====+==== How to Get License Keys ====
  
 After purchasing the desired number of licenses, the Vistasource licensing department at [[licensing@vistasource.com]] will issue valid license keys. After purchasing the desired number of licenses, the Vistasource licensing department at [[licensing@vistasource.com]] will issue valid license keys.
Line 147: Line 163:
 There are two ways to get this MAC Ethernet Address from your PC: There are two ways to get this MAC Ethernet Address from your PC:
  
-1. After installing RTW, execute the FLEXlm tool lmtools.exe that is located in the install directory for  RTW, Version 4.4. Run lmtools.exe to start the program. You will see the dialog box "​LMTOOLS by Flexera Software, Inc.", which contains several tabs. Click on the tab "​System Settings"​. The MAC Ethernet address is located in the field "​Ethernet Address"​. Copy the number and forward it to the Vistasource licensing department.+1. After installing RTW, execute the FLEXlm tool lmtools that is located in the install directory for  RTW. Run lmtools to start the program. You will see the dialog box "​LMTOOLS by Flexera Software, Inc.", which contains several tabs. Click on the tab "​System Settings"​. The MAC Ethernet address is located in the field "​Ethernet Address"​. Copy the number and forward it to the Vistasource licensing department.
  
 2. If Vistasource RTW is not installed on the machine which will be the license server, you can use a DOS tool to get the MAC Ethernet address for that machine. In a DOS Shell window, run the command "​ipconfig/​all"​. Part of the output is the Physical Address, for instance, "​00-02-A5-53-C0-D4"​. Next, you need to delete the hyphens between the numbers to convert the physical address in a format that can be used for creating license keys: "​0002A553C0D4" ​ 2. If Vistasource RTW is not installed on the machine which will be the license server, you can use a DOS tool to get the MAC Ethernet address for that machine. In a DOS Shell window, run the command "​ipconfig/​all"​. Part of the output is the Physical Address, for instance, "​00-02-A5-53-C0-D4"​. Next, you need to delete the hyphens between the numbers to convert the physical address in a format that can be used for creating license keys: "​0002A553C0D4" ​
  
-==== Why you need a "​C:"​ drive" ==== 
  
 +==== Setup and Configuration ====
  
-In some cases we have found that the the FLEXlm product requires a "​C:"​ drive for its installation. ​ If your machine does not have a "​C:"​ drive, and you are experiencing problems with the license setup, you may need to map the "​C:"​ drive to the drive where you want to install the product. ​ +<note important>​In some cases we have found that the the FLEXlm product requires a "​C:"​ drive for its installation. ​ If your machine does not have a "​C:"​ drive, and you are experiencing problems with the license setup, you may need to map the "​C:"​ drive to the drive where you want to install the product. ​</​note> ​
  
  
-==== Setup and Configuration ==== +Flexlm'​s configuration tool LMTools:
- +
-To run Vistasource RTW and its engines as licensed products, you need to set up a license server:+
  
-{{:rtw_4.4:lmtools.4.4.jpg?direct&|}}+{{ :rtw_4.5:lmtools.png?nolink ​|}}
  
-  - Launch lmtools.exe which is located in the install directory.+  - Launch lmtools which is located in the install directory.
   - In the "​Service/​License File" tab choose "​Configuration using Services"​. ​   - In the "​Service/​License File" tab choose "​Configuration using Services"​. ​
   - In the "​Config Services"​ tab, type "​License Server"​ in the field "​Service Name".   - In the "​Config Services"​ tab, type "​License Server"​ in the field "​Service Name".
-  - Put in the path for lmgrd.exe and the license file. The lmgrd.exe is in the install directory.+  - Put in the path for lmgrd.exe and the license file. The file lmgrd is in the install directory.
   - Put in the path to your /temp directory for the debug log and name it lmgrd_vistasrc.log.   - Put in the path to your /temp directory for the debug log and name it lmgrd_vistasrc.log.
   - Toggle on "Use Services"​   - Toggle on "Use Services"​