MARS Licensing and Installation Guide

Transcription

1 MARS Licensing and Installation Guide 2018 Merrick & Company

2 Table of Contents Purpose... 3 Microsoft Updates Requirement... 3 Installation Notes... 3 Part I MARS Licensing MARS Trial Version Evaluation License... 4 MARS Academic Version... 6 MAC Address Identification Instructions Temporary License... 7 Locking Code Discovery Instructions for Standalone (Keyed or Keyless) or Network - Permanent License Part II MARS Software Installation MARS Software Installation Instructions Part III Post-Installation (Network only) Post-Installation (Network) Instructions Part IV Commuter Licensing (Network only) Commuter Licensing May 29, 2018 Page 1

3 Table of Contents (cont.) Part V License Administration (Network only) License Administration Part VI FAQs and Troubleshooting FAQs and Troubleshooting for Installation, Licensing, and Program Errors MARS Technical Support Contact Information May 29, 2018 Page 2

4 Purpose The purpose of this document is to provide user instructions and troubleshooting tips for the licensing, network administration, and installation of the MARS version software suite. Please read the applicable sections of this guide before installing and licensing the MARS software. Microsoft Updates Requirement Please note that MARS requires all license server and client Windows computers be updated with the latest Microsoft operating system service packs, security updates, and patches. In certain situations, a computer may not have administrative rights to install updates contact your network administrator or IT specialist. To manually update a computer with all the latest Microsoft software updates, please visit the following website: Please note that it may take several cycles to complete all available updates, as some updates will prompt additional dependent ones. Installation Notes MARS or later requires a 64-bit Windows operating system. Screen shots were taken using Windows 7 or Windows 10. Depending on the computer s operating system, User Account Control settings, and existence or absence of certain Windows components, not all of the dialog boxes presented in this guide may appear, or there may be additional ones -- please respond in the affirmative to any additional prompts. May 29, 2018 Page 3

5 Part I MARS Licensing MARS Trial Version Evaluation License Introduction This section provides instructions for setting up and licensing a 30-day trial version of MARS. This version is locked to the computer where originally installed and operates with restricted functionality and file size limits, as defined within the MARS Functionality Matrix (available here). NOTE** - The 30-day MARS Evaluation can be used only once on any given computer. Please refer to Step 3 (below) for information on using MARS in FreeView mode after the trial period has expired. To purchase a permanent license, please contact Josh Beck, Senior Software Consultant: Toll-free (800) x3715, Direct (303) , or josh.beck@merrick.com Step 1: Download the Software and Evaluation License Click on the link to DOWNLOAD the 64-bit MARS installer ZIP file. Also, be sure to download the Evaluation license ZIP file using the link in the auto-response that will be sent out after the download has started. Without this license, MARS will operate only in FreeView mode as a free, read-only LiDAR data viewer. Step 2: Install MARS client software Please refer to Part II Installation beginning on Page 19 in this guide to complete the MARS client software installation on the target computer. When the installation is complete, return to this section and continue with Step 3. Step 3: Copy Evaluation License Using Windows Explorer, navigate to the MARS Evaluation license ZIP file downloaded in Step 1 and extract the contents to a local drive. When the extract has completed, copy the license file lservrc into the MARS installation directory (C:\MARS by default). The trial period will begin the first time MARS is run. Once the 30-day license has expired, please delete the MARS license file ( lservrc ) to use MARS FreeView, our free LiDAR data viewer. May 29, 2018 Page 4

6 Step 4: Launch MARS To launch the MARS software application, click Start All Programs MARS MARS or doubleclick the MARS desktop shortcut (Figure 1) that was created during installation. Figure 1: MARS desktop icon If the following message (Figure 2) appears upon startup, please use the link to contact MARS Sales, or refer to the NOTE on the previous page. Figure 2: MARS Evaluation license warning May 29, 2018 Page 5

7 MARS Academic Version Introduction This section provides instructions for setting up and licensing an Academic version of MARS. This version uses a standalone limited time license (typically 120 days or one academic semester) and operates with the same functionality as an Explorer-level license, as defined within the MARS Functionality Matrix (available here). Please contact Josh Beck, Senior Software Consultant, for academic eligibility requirements: Toll-free (800) x3715, Direct (303) , or josh.beck@merrick.com Step 1: Install MARS client software Please refer to Part II Installation beginning on Page 19 in this guide to complete the MARS client software installation on the target computer. When installation is complete, return to this section and continue with Step 2. Step 2: Copy Academic License Using Windows Explorer, copy the license file lservrc supplied by Merrick & Company into the MARS installation directory (C:\MARS by default). The limited time period will begin the first time MARS is run. When the license has expired, please contact MARS technical support (see Page 52) to obtain a new license file. Step 3: Launch MARS To launch the MARS software application, click Start All Programs MARS MARS or doubleclick the MARS desktop shortcut (Figure 3) that was created during installation. Figure 3: MARS desktop icon If the following message (Figure 4) appears upon startup, please use the link to contact MARS Sales, or refer to Step 2 (above) to inquire about renewing the Academic license. Figure 4: MARS Evaluation (Academic) license warning May 29, 2018 Page 6

8 MAC Address Identification Instructions Temporary License Introduction This section provides end-user instructions for the identification of the MAC address on a target computer. In computer terminology, a Media Access Control (MAC) address is a unique identifier assigned to network adapters and other network-ready devices by the computer, network card, or device manufacturer for identification purposes. The MAC address information is used to generate a temporary MARS license file that will be locked to the target computer for a pre-defined time period. Please read the complete section before attempting to identify the system s MAC address. Step 1: Open Command Prompt In order to identify the computer s MAC address, the user will need a Command Prompt window. To open this window in Windows 7, click Start All Programs Accessories Command Prompt. Windows PowerShell may also be used in Windows 10 and Windows Server 2012 R2. Alternatively, the user may use the cmd command in a Run window (if enabled) to launch the Command Prompt window. (Figure 5) Figure 5: Run dialog in Windows 7 In Windows 10, right-click on the Start button, then click Command Prompt (Admin) in the list that appears. Some versions of Windows 10 have replaced this with Windows PowerShell (Admin). May 29, 2018 Page 7

9 Once the cmd command is issued, the following window (Figure 6) is displayed. Figure 6: Command Prompt window Step 2: Issue ipconfig Command Type ipconfig /all at the command prompt and hit the Enter key to issue the command (Figure 7). Note that there is a space before the slash but not after it. Figure 7: Command Prompt window (displaying ipconfig /all command) Following the issuance of the ipconfig /all command, the Command Prompt window will display the system s network information (Figure 8). May 29, 2018 Page 8

10 Figure 8: Command Prompt window showing System Network information Step 3: Document MAC Address From the network information that is returned, please document the value displayed on the Physical Address line of the window. The standard format for MAC addresses is six groups of two hexadecimal characters, separated by hyphens (-). Alpha characters are not case sensitive. For example, the MAC address of the displayed network information in Figure 8 is: A-A1 Step 4: Send MAC Address to Merrick & Company The next step in this process involves providing the MAC address information to Merrick & Company for the generation of the temporary MARS software license. The temporary license file is in an XML format and the license duration can be extended if necessary. Please the MAC address information to Mark Stucky (mark.stucky@merrick.com) or the MARS Technical Support address (MARSsupport@merrick.com) for temporary license generation. May 29, 2018 Page 9

11 Step 5: Install MARS client software Please refer to Part II Installation beginning on Page 19 in this guide to complete the MARS client software installation on the target computer. When installation is complete, return to this section and continue with Step 6. Step 6: Copy Temporary License Delete or move any existing MARS license files from the MARS installation directory (C:\MARS by default), then copy the provided MARS temporary license file license.xml into this same directory. The temporary license file can be created for different license levels as agreed upon by Merrick and the end user. See the MARS Functionality Matrix (available here) for details of the various levels. Once the pre-defined time period of the license has expired, please delete the MARS license file ( license.xml ) to use MARS FreeView, our free LiDAR data viewer. Step 7: Launch MARS To launch the MARS software application, click Start All Programs MARS MARS or doubleclick the MARS desktop shortcut (Figure 9) that was created during installation. Figure 9: MARS desktop icon If the following message (Figure 10) appears upon startup, please use the link to contact MARS Sales. Figure 10: MARS Temporary license warning May 29, 2018 Page 10

12 Locking Code Discovery Instructions for Standalone (Keyed or Keyless) or Network - Permanent License Introduction There are three possible licensing configurations for a Permanent MARS installation: Standalone (Keyed), Standalone (Keyless), or Floating Network. Standalone (Keyed) uses a USB hardware key that allows any computer it is plugged into to acquire the MARS license. Standalone (Keyless) is node-locked to one specific computer and cannot be transferred to another. Floating Network uses a computer on the user s network as a license server, and client computers on the same network can acquire a license without needing a hardware key. The Floating Network method also allows a computer - typically a laptop - to commute (borrow) a license and disconnect from the network for off-site use. This section provides instructions for determining the locking code(s), using SafeNet s Wechoid utility, for all three methods. Once identified, these locking codes will be used to generate a permanent MARS software license. The license will authorize the appropriate MARS functions depending on the license level purchased, as defined within the MARS Functionality Matrix (available here). This section also covers the installation of the Sentinel RMS License Manager software for Network setups. Please read the entire section before beginning. NOTE** - For a first-time Standalone (Keyed) installation, Merrick & Company will deliver the USB hardware key along with the pre-configured license file. In this case, please skip to Page 18, Step 7. Step 1: Download Locking Code Discovery Software (Wechoid) Using the following link, please copy the file listed below to the target computer. If prompted, navigate to the desired local directory and click Save to copy the file locally. 1. wechoid.zip (620 KB) Download Remove the Sentinel USB hardware key from the target computer if switching from Keyed to Standalone (Keyless) or Network. Step 2A: If Licensing Configuration is Standalone (Keyed) On the client computer, insert the Sentinel USB hardware key into an active USB port. This action will cause a Windows status message to be displayed in the notification area of the taskbar. If the driver is properly installed, the computer will automatically recognize the USB hardware key. If the key is not recognized by Windows, download, unzip, and install the Sentinel System Drivers, accepting all defaults. A reboot may be required after the driver installation. Go to Step 3A (Page 12). May 29, 2018 Page 11

13 Step 2B: If Licensing Configuration is Standalone (Keyless), Proceed to Step 3B (Page 13) Step 2C: If Licensing Configuration is Network, Proceed to Step 3C (Page 14) Step 3A: Determine Locking Code on USB hardware key for Standalone (Keyed) Unzip the wechoid.zip file (downloaded in Step 1) locally and double-click the file named wechoid.exe to launch the locking code display. To determine the locking code of the hardware key, uncheck all of the boxes within the Wechoid display except for the Computer ID option (Figure 11). With the Selector value displaying 0x80, document the locking code value (example below, *164 9YZP SRC2 JMBG) displayed in the Code textbox for license generation purposes. Proceed to Step 4 (Page 15). Figure 11: Wechoid dialog Computer ID locking code May 29, 2018 Page 12

14 Step 3B: Determine Locking Code for Standalone (Keyless) Unzip the wechoid.zip file (downloaded in Step 1) locally and double-click the file named wechoid.exe to launch the locking code display. To determine the locking code, uncheck all of the boxes within the Wechoid display except for the Ethernet Address option (Figure 12). With the Selector value displaying 0x10, document the locking code value (example below, *1YG 3J9U GJD8 4UPS) displayed in the Code textbox for license generation purposes. Proceed to Step 4 (Page 15). Figure 12: Wechoid dialog Ethernet Address locking code May 29, 2018 Page 13

15 Step 3C: Determine Locking Codes for Network Configuration Unzip the wechoid.zip file (downloaded in Step 1) locally and double-click the file named wechoid.exe to launch the locking code display. To determine the primary locking code, uncheck all of the boxes within the Wechoid display except for the Host Name option (Figure 13). With the Selector value displaying 0x8, document the primary locking code value (example below, *1SL BYM5 LELX 2ECQ) displayed in the Code textbox for license generation purposes. Figure 13: Wechoid dialog server Host Name locking code May 29, 2018 Page 14

16 To determine the secondary locking code, uncheck all of the boxes within the Wechoid display except for the IP Address option (Figure 14). With the Selector value displaying 0x2, document the secondary locking code value (example below, *1CB 2BDU PL8W VFQK) displayed in the Code textbox for license generation purposes. Figure 14: Wechoid dialog server IP Address locking code Step 4: Send Locking Code(s) to Merrick & Company Once the user has determined the primary and secondary locking codes (Network configuration), or the single locking code of the Sentinel USB hardware key (Standalone Keyed configuration), or the single locking code of the target computer (Standalone Keyless Configuration), please send them to Mark Stucky MARS Technical Support Specialist, for license generation. For the Keyed option, please be sure to include the serial number of the USB hardware key, which is printed on the side of the key housing beginning with the text S/N:. May 29, 2018 Page 15

17 Step 5A: If Licensing Configuration is Standalone (Keyed or Keyless), Proceed to Step 6 (Page 18) Step 5B: If Licensing Configuration is Network, Install the Sentinel RMS License Manager Software In order to configure the server computer s environment to support network licensing, please perform the following steps to set up the Sentinel RMS License Manager server. a: Download and Install Sentinel RMS License Manager software Using the following link, please copy the Sentinel RMS License Manager Installer software shown below to the server computer. If prompted, navigate to the desired local directory and click Save to copy the file locally. 1. Sentinel_RMS_License_Manager_Installer.zip (9.0 MB) Download Unzip the file locally and double-click the file named setup.exe to launch the software installation program. Accept all the default settings during the installation process. b: Copy Permanent License (Network) Please copy the provided MARS license file (lservrc) to one of the following directories (depending on whether the server is running a 32-bit or 64-bit version of Windows, respectively) on the server computer hosting the Sentinel RMS License Manager, overwriting any existing lservrc file. C:\Program Files\Common Files\SafeNet Sentinel\Sentinel RMS License Manager\WinNT -or- C:\Program Files (x86)\common Files\SafeNet Sentinel\Sentinel RMS License Manager\WinNT If this exact path does not exist on the server computer, search the system to locate the installation directory for the Sentinel RMS License Manager. The license will authorize the appropriate MARS functions depending on the license level purchased, as defined within the MARS Functionality Matrix (available here). c: Stop/Restart Sentinel RMS License Manager Service In order for Sentinel to recognize and utilize the MARS network license file, the Sentinel RMS License Manager service must be stopped and restarted on the server computer. May 29, 2018 Page 16

18 To access the Sentinel RMS License Manager service (Figure 15), please launch the Services dialog by double-clicking the Services option within the Administrative Tools dialog. This dialog can be accessed from the Control Panel (Start Control Panel). Figure 15: Windows Services dialog Locate the Sentinel RMS License Manager service and select it by clicking on the service name. To stop the service, right-click on the highlighted service and select the Stop option or click the Stop Service button near the top of the dialog s interface. The following dialog (Figure 16) will be displayed until the service has completely stopped. Figure 16: Service Control dialog stopping a service To restart the Sentinel RMS License Manager service, right-click on the highlighted service and select the Start option or click the Start Service button near the top of the dialog s interface. The following dialog (Figure 17) will be displayed until the service has completely started. May 29, 2018 Page 17

19 Figure 17: Service Control dialog starting a service Step 6: Install MARS client software Please refer to Part II Installation beginning on Page 19 in this guide to complete the MARS client software installation on all target computers. When installation is complete, return to this section and continue with Step 7 (Standalone), or proceed to Part III Post-Installation (Network) on Page 34. Step 7: Copy Permanent License (Standalone Keyed or Keyless) Delete any MARS temporary license files (license.xml) from the MARS installation directory (C:\MARS by default), then copy the new permanent license file lservrc into this same directory. The license will authorize the appropriate MARS functions depending on the license level purchased, as defined within the MARS Functionality Matrix (available here). Step 8: Launch MARS For a Keyed configuration, insert the USB key before starting the program. To launch the MARS software application, click Start All Programs MARS MARS or doubleclick the MARS desktop shortcut (Figure 18) that was created during installation. Figure 18: MARS desktop icon May 29, 2018 Page 18

20 Part II MARS Software Installation Introduction This section provides instructions for first-time installation or in-place upgrade of the version MARS software suite and sample data on client machines. Please fully read this section before starting the MARS installation procedure. Step 1: Install MARS on Client Computer(s) Using Windows Explorer (File Explorer), navigate to the downloaded MARS installer ZIP file on the local drive of the target computer and extract the installer files. Once the extract has completed, please navigate to the MARS installation executable (setup.exe) as displayed in Figure 19. Begin the MARS software installation by double-clicking the setup.exe file. Note that on some systems, setup.exe may need to be run as an administrator. Figure 19: MARS installation executable (setup.exe) NOTES for upgrade installations: 1. Not all windows and dialog boxes shown in the following pages will appear during an in-place upgrade. Typically, the first pop-up will be as shown in either Figure 26 or 27 (Page 23). 2. Any existing MARSBreaklineProperties.xml file will be migrated from the old installation folder to the new one. NOTE: If at any point during the following Microsoft Visual C++ Runtime installation a prompt for a reboot appears, accept it and run setup.exe again (see above) to continue with the MARS installation. May 29, 2018 Page 19

21 Immediately following the launch of the MARS installation executable, the following dialog will be displayed as the Windows Installer software scans the computer hard drive for system resources (Figure 20). Figure 20: Windows Installer dialog Following this window, the Microsoft Visual C Runtime (x64) installation will begin (Figure 21), unless it already exists on the computer. Note that this package is also referred to as Visual C++ 14 Runtime Libraries (x64). Click Install to continue. Figure 21: Visual C++ 14 Runtime Libraries (x64) installation dialog A progress bar screen (Figure 22) will appear, followed by the license terms screen (Figure 23). The exact version number of the Microsoft Visual C Redistributable (x64) may vary from the example screen shot shown below. Check the I agree box and then click Install. May 29, 2018 Page 20

22 Figure 22: Visual C++ 14 Runtime Libraries (x64) installation progress bar Figure 23: Visual C license terms Installation will then begin for this Windows component (Figure 24), followed by a completion screen (Figure 25). Click Finish to continue with installation. May 29, 2018 Page 21

23 Figure 24: Visual C Installation progress Figure 25: Visual C Setup Successful screen After the Microsoft Visual C Close button is clicked, the following dialog (Figure 26) will be displayed to show the status of the MARS software installation. May 29, 2018 Page 22

24 Figure 26: Windows Installer dialog NOTE for Windows 7 and later users: At this point, a Program Compatibility Assistant window may open saying that there may be a problem with program installation. In our testing we have not detected any error, so please click on This program installed correctly. To continue with the MARS software installation, click the Next > button (Figure 27). Figure 27: MARS installation dialog May 29, 2018 Page 23

25 The user will then be prompted to accept the MARS end-user license agreement (Figure 28). To continue with the MARS software installation, review the license agreement, select the I Agree radio button, and then click the Next > button. Figure 28: MARS end-user license agreement acceptance dialog If the user chooses not to accept the license agreement, the MARS software installer will close and the installation process will terminate. May 29, 2018 Page 24

26 The user will then be prompted to define the MARS installation directory within the Folder: text box of the following dialog (Figure 29). Click Browse to navigate to the desired local directory. Please note that we recommend MARS be installed into the default location (C:\MARS) as shown below. Figure 29: MARS installation dialog Click Next > to continue with the software installation. May 29, 2018 Page 25

27 The following dialog (Figure 30) will be displayed to confirm the user s intention to install the MARS software application. Click Next > to continue with the software installation. Figure 30: MARS installation confirmation dialog May 29, 2018 Page 26

28 During the MARS software installation, the following installation status dialog (Figure 31) will be displayed. Figure 31: MARS installation status dialog May 29, 2018 Page 27

29 MARS software users have the opportunity to navigate around the program and try out the various tools and functions using a sample data set. The MARS sample data folder includes the following geospatial data files (plus some auxiliary files): LiDAR (LAS) Data MARS_Sample_LiDAR.las Orthophotography MARS_Sample_Image_Mosaic.ecw Tile Scheme MARS_Sample_Project_Tiles.shp Project Boundary MARS_Sample_Project_Boundary.shp Ground Check Points MARS_Sample_Check_Pts.csv Compiled Breaklines MARS_Sample_Breaklines.shp Metadata Sample_Dataset_Metadata.txt The sample data will be automatically extracted and copied into the MARS Sample_Data folder during the installation process, as shown in the destination folder box (Figure 32). On some systems, this window will remain hidden behind the installation progress window shown on the previous page (Figure 31). Once complete, the sample data folder size will be approximately 284 MB. Figure 32: MARS Sample Data extraction status dialog May 29, 2018 Page 28

30 Vertical transformation files used for converting vertical datums and/or height models from one system to another will not be included in the MARS software installer. A prompt will appear (Figure 33) with an option to download a self-extracting executable that will install the vertical files before continuing with the installation. In the case of an upgrade, a check will be made in the install path to see if existing vertical files are current. If so, installation will continue normally. If they are not current, the prompt in Figure 33 will appear. Depending on connection speed, this process may take minutes. Once started (Figure 34), the download can be canceled and the vertical files package can be downloaded separately at a later date by contacting MARS Technical Support at (MARSsupport@merrick.com). Note that several minutes may pass after the progress bar reaches 100% due to the time it takes to extract the files from the download. Please note that depending on the security and permission settings of individual computers, the selfextraction process may not run automatically. Check the C:\MARS\GeoCalc\Data\ShiftFiles\vertical\ folder to see if the files were extracted. If no files exist other than the vertical_mmddyyyy.exe selfextractor, double-click on it to start the extraction process. Leave the vertical_mmddyyyy.exe file in the folder when complete so that MARS can check the status of the files during future updates. Figure 33: Download vertical files prompt Figure 34: Vertical files download progress May 29, 2018 Page 29

31 NOTE: If a pop-up appears asking whether an existing file named MARS_QAT.xml should be replaced, the answer will depend on whether the MARS Quick Access Toolbar has been customized since the last install/upgrade. This file holds information about the Quick Access buttons and their order of appearance by default, 10 buttons are initially included. If no customizing has been done to the toolbar buttons, answer Yes and allow the installer to put the latest version of the file in the install folder, overwriting the existing one. Otherwise, answer No to keep the existing version of the file. The pop-up may be hidden behind the installation window. NOTE: If a pop-up appears asking whether an existing file named geodata_73.xvw should be replaced, the answer will depend on whether any custom coordinate systems have been created in GeoEdit, which would have created a new custom.xml file and modified the existing geodata_73.xvw file. If new systems were created, any custom.xml file will be migrated from the old installation folder to the new one, and the existing geodata_73.xvw should be kept to ensure that any new systems will appear in the correct folder structure when browsing for them in GeoCalc, GeoTranslate, or GeoEdit. Contact MARSsupport@merrick.com for instructions on making a minor modification to the geodata_73.xvw file if the original version is kept. Note that the pop-up may be hidden behind the installation window. It is highly recommended the most current video driver be loaded on the workstation for stability and optimum rendering of data. Please check for current video drivers on the computer or graphics card manufacturer s website. The following dialog (Figure 35) will be displayed during installation to remind users to update their video driver, if necessary. The installation routine will not automatically update any video drivers. Click Next > to continue with the MARS software installation. Figure 35: Video Driver Requirement update message May 29, 2018 Page 30

32 To obtain optimum video playback when using the Video Hyperlink Playback tool in MARS, please download and install the video CODEC (COde/DECode) package as mentioned in the install screen shown in Figure 36. This can be done following the reboot step (Page 32). Click Next > to continue with the MARS software installation. Figure 36: Video playback requirement message May 29, 2018 Page 31

33 Once the software installation has completed (Figure 37), click Close to exit the installer program. Figure 37: MARS software installation completion dialog Step 2: Reboot Computer Finally, the user will be prompted (Figure 38) to restart the computer in order to incorporate the software configuration changes performed during installation. Click the Yes button to reboot the computer, then proceed to the next step. Figure 38: System restart dialog May 29, 2018 Page 32

34 After the system has restarted, return to: Page 4, Step 3 if running an Evaluation license Page 6, Step 2 if running an Academic license Page 10, Step 6 if running a Temporary license Page 18, Step 7 if running a Permanent (Standalone) license or go to: Part III Post-Installation (Network), Page 34 if running a Network license May 29, 2018 Page 33

35 Part III Post-Installation (Network only) Introduction This section provides instructions on setting up client computers to be able to access MARS licenses on a network license server. The license server is the computer running the Sentinel RMS License Manager software (Part I - MARS Licensing, Page 16, Step 5B). Step 1: Client Configuration Environment Variables The user will need to set a Windows System environment variable on each client computer in order to acquire a license from the license server. A variable named LSFORCEHOST is used for this purpose. The following paragraphs and figures detail the creation and use of this system variable. Perform these steps for all installed client computers that will need access to a MARS license. To assign a new environment variable, click Start Control Panel to access the System icon, which can be clicked to open (if the Control Panel is displayed in category mode, click Performance and Maintenance to get to the System icon). This action will display the System Properties dialog click the Advanced tab ( Advanced System Settings in Windows 7) and then click the Environment Variables button near the bottom of the dialog. This action will display the Environment Variables dialog. Click the New button in the System Variables section and create the LSFORCEHOST environment variable with the following parameters (Figure 39): Variable name: LSFORCEHOST Variable value: <License Server computer name> (ex. lmserver-wks) Figure 39: New System Variable dialog - LSFORCEHOST May 29, 2018 Page 34

36 Click the OK button to save the changes to the LSFORCEHOST environment variable, then click the OK button on the Environment Variables dialog. Finally, click the OK button on the System Properties dialog and close the Control Panel to complete this step. For optimal network licensing performance, all computers must operate within the same network Subnet. In addition, the installer should be able to ping the license server computer name from a Command Prompt window to verify that the license server is visible on the target network. Step 2: Launch MARS To launch the MARS software application, click Start All Programs MARS MARS or doubleclick the MARS desktop shortcut (Figure 40) that was created during installation. Figure 40: MARS desktop icon May 29, 2018 Page 35

37 Part IV Commuter Licensing (Network only) Introduction This section provides end-user instructions for the use of the commuter license feature within the MARS software suite. The commuter license feature allows the user to check-out/check-in a network-based MARS software license from the Sentinel RMS License Manager for use in the field or when otherwise disconnected from the network. The maximum check-out time is 1827 days. Once the user returns to the office, it is strongly suggested that the software license be checked back into the Sentinel RMS License Manager so that other users may access the license. Remember, all checkout and check-in procedures must be performed while the computer is connected to the same network that the License Server computer is part of. Please read the entire section before utilizing the commuter license feature to check-out/check-in a MARS software license. First time initialization of a computer prior to using the Commute function This procedure needs to be done only once for each computer (unless a different license type and/or version number is needed, or the C:\MARS folder is deleted) that will use MARS while disconnected from the network license server. 1. Using a text editor (e.g., Notepad), create a one-line text file called commute.txt The single line of text must read: RandomGUID MARSEXPL 2018 if an Explorer license will be commuted, RandomGUID MARSEXQC 2018 if an Explorer QC license will be commuted, RandomGUID MARSPROD 2018 if a Production license will be commuted, or RandomGUID MARSPRPL 2018 if a Production and Powerline license will be commuted. Upper and lower cases must be observed as shown. Also, make sure there is no blank line after the single line of text. 2. Copy the completed commute.txt file into the C:\MARS folder. 3. From an Administrative Command Prompt window, navigate to the C:\MARS folder. 4. At the prompt, type lsgeninit.exe commute.txt and hit the Enter key. At the prompt, hit Enter again to continue. This will generate a file called lsinit.exe which will silently overwrite any older version. 5. At the prompt, type lsinit.exe debug and hit the Enter key. A new command prompt window will open hit Enter again to continue. 6. Close the original Command Prompt window. Step 1: Launch Commuter Licensing dialog In order to check-out the software license, the user must launch the Commuter Licensing dialog. May 29, 2018 Page 36

38 To access this dialog, click Start All Programs MARS Licensing Commute License. The following dialog (Figure 41) is displayed. Figure 41: Commuter Licensing dialog Click the Single Server button to access the Sentinel RMS License Manager service on the license server computer. Once the Specific Server dialog is displayed (Figure 42), type the name of the server computer hosting the Sentinel RMS License Manager service and click the OK button. Figure 42: Specific Server dialog After connecting to the Sentinel RMS License Manager, the following dialogs (Figures 43 and 44) show the available licenses for check-out. In this example, there are a total of two (2) MARS Explorer (MARSEXPL) and three (3) MARS Production (MARSPROD) commuter licenses available to May 29, 2018 Page 37

39 the users of this organization. Any or all licenses may be checked out (up to the limit of available licenses), one per client computer. Figure 43: Commuter Licensing dialog Explorer Figure 44: Commuter Licensing dialog - Production May 29, 2018 Page 38

40 Step 2: License Check-Out Procedure To check-out a license, the user must select the Feature line within the left pane of the dialog and click the Check Out button. Once the license has been checked out, the Commuter Licensing dialog is updated as shown in the following display (Figure 45). NOTE** - Leave the Check out authorization for remote machine box unchecked. This feature has not been implemented, and checking this box will cause the Commuter Licensing process to fail. Figure 45: Commuter Licensing dialog Please exit the Commuter Licensing dialog by clicking the File menu and selecting the Exit option, or by clicking on the red X in the upper-right corner of the dialog. Step 3: Update/Create Environment Variable Now that the MARS license has been checked out, the user must update the client computer s LSFORCEHOST environment variable. To edit the LSFORCEHOST environment variable, click Start Control Panel to access the System icon, which can be clicked to open. This action will display the System Properties dialog. Click the Advanced tab ( Advanced System Settings in May 29, 2018 Page 39

41 Windows 7) and then click the Environment Variables button near the bottom of the dialog. This action will display the Environment Variables dialog. Scroll down the variable listing within the System Variables section of the Environment Variables dialog and select the LSFORCEHOST environment variable. Click the Edit button and modify the Variable value: setting to no-net, as displayed below in Figure 46. Figure 46: Edit System Variable dialog (LSFORCEHOST) Click the OK button to save the changes to the LSFORCEHOST environment variable, then click the OK button on the Environment Variables dialog. Finally, click the OK button on the System Properties dialog and close the Control Panel to complete this step. Step 4: MARS Usage Following the successful check-out of the MARS license and the modification of the LSFORCEHOST environment variable, the user may operate the MARS application detached from the organization s IT network. A desktop icon named MARS was previously created for the user as part of the software installation. Please double-click this icon to launch the MARS software application. Step 5: License Check-In Procedure To start the license check-in process, the user must launch the Commuter Licensing dialog after reconnecting to the network. To access this dialog, click Start All Programs MARS Licensing Commute License. Click the Single Server button to access the Sentinel RMS License Manager service on a specific computer. Once the Specific Server dialog is displayed (Figure 42), type the name of the computer hosting the Sentinel RMS License Manager service (the same one used in Step 1) and click the OK button. May 29, 2018 Page 40

42 To check-in a MARS license, click on the checked-out license in the left pane of the dialog, and then click the Check In button, as displayed in Figure 47. Figure 47: Commuter Licensing dialog Once the MARS license has been successfully checked back in to the Sentinel RMS License Manager, the Commuter Licensing dialog will be updated with the network license settings (Figure 48). Figure 48: Updated Commuter Licensing dialog May 29, 2018 Page 41

43 Please exit the Commuter Licensing dialog by clicking the File menu and selecting the Exit option, or by clicking on the red X in the upper-right corner of the dialog. Step 6: Reset/Delete Environment Variable Since the MARS license has been checked back in, the user must reset the client computer s LSFORCEHOST environment variable. To edit the LSFORCEHOST environment variable, click Start Control Panel to access the System icon, which can be clicked to open. This action will display the System Properties dialog. Click the Advanced tab ( Advanced System Settings in Windows 7) and then click the Environment Variables button near the bottom of the dialog. This action will display the Environment Variables dialog. Scroll down the variable listing within the System Variables section of the Environment Variables dialog and select the LSFORCEHOST environment variable. Click the Edit button and modify the Variable Value: setting to the name of the computer hosting the Sentinel RMS License Manager service. An example is displayed below in Figure 49. Variable Name: LSFORCEHOST Variable Value: <License Server computer name> (ex. mars-test-vm) Figure 49: Edit System Variable dialog (LSFORCEHOST) Click the OK button to save the changes to the LSFORCEHOST environment variable, then click the OK button on the Environment Variables dialog. Finally, click the OK button on the System Properties dialog and close the Control Panel to complete this step. May 29, 2018 Page 42

44 Part V License Administration (Network only) Introduction This section provides end-user instructions for the License Manager Administration (WlmAdmin) tool. This tool aids network administrators in viewing and managing MARS licenses and license servers. Please read the entire section before attempting to use this tool. What Does WlmAdmin Do? WlmAdmin performs a variety of administrative functions. It displays comprehensive information which includes the license server information, feature information, and license and client information. A few of the most important functions are listed below: Provides information on license servers detected Monitors the license server transactions Displays details on active licenses Provides information about the licensed users Tasks That Can Be Performed with WlmAdmin Set WlmAdmin Preferences Select the License Servers Perform License Server-Specific Actions Perform License-Specific Actions To use the WlmAdmin tool, click Start All Programs MARS Licensing WlmAdmin Tool May 29, 2018 Page 43

45 Setting WlmAdmin Preferences WlmAdmin allows the user to choose what to display when it starts. From the Edit menu, select the Preferences command to view the WlmAdmin Preferences dialog box (Figure 50). Figure 50: WlmAdmin Edit Menu May 29, 2018 Page 44

46 To set the Timeout interval, specify the number of seconds after which WlmAdmin will stop trying to contact a license server. If the network is large or slow, you might want to increase this number if you find WlmAdmin has difficulty retrieving information from the license servers. To set the Broadcast interval, specify the number of seconds between broadcasts to the network to discover license servers. To automatically discover and display the license servers on your subnet, select the Discover subnet servers on startup check box. To always show the license servers that have been defined, select the Discover defined servers on startup check box. Unselect Hide client library error handler messages to pass license management error messages from the Sentinel RMS Development Kit through to WlmAdmin. Be sure to select Save these preferences to a file to save your choices (Figure 51). Figure 51: WlmAdmin Preferences dialog Selecting the License Servers The first step to using WlmAdmin is to select what license servers you are interested in monitoring. To create a list of defined license servers: 1. Go to the Edit menu and select the Defined Server List command. 2. Type a license server name and click the Add button to add a server to the list (Figure 52). If you are not sure of the license server computer s host name, you can wait for WlmAdmin to display license servers in the Subnet Servers area of the left-hand pane of the main window to see what license servers are available on the network. 3. Once a license server is defined, you can add more or select a server and click Remove to remove it from the list. 4. Click OK to return to the main WlmAdmin screen. May 29, 2018 Page 45

47 Figure 52: Defined Server List dialog To discover all license servers on your network subnet: Go to the left-hand pane of the main WlmAdmin window and double-click Subnet Servers. WlmAdmin will broadcast to the network to discover all license servers and display them here. To refresh the network display Right-click on Defined Servers or Subnet Servers and select Refresh to tell WlmAdmin to display new information on that group of license servers. You may also select Refresh All from the View menu to refresh the display for all license servers shown. License Server-Specific Actions The following actions affect license servers. To see information on a license server: Click the name of a license server in the left-hand pane of the main window (Figure 50). In the righthand pane of the display, you see the IP address of the computer containing the license server and its host name. To add or remove a license server from the Defined Server List: Right-click the name of a license server in the left-hand pane of the main window. From the menu select Add to Defined List or Remove from Defined List. May 29, 2018 Page 46

48 To change the log file for a selected license server: To begin a new log file for a selected license server, right-click the license server and select Change log file name. By default, the usage log file (lservsta) is created in the <OSdrive>:\WINDOWS\system32 directory. To shut down a license server: Right-click the name of a license server in the left-hand pane of the main window (Figure 50). From the menu select Shutdown Server. License-Specific Actions The following actions affect individual licenses. To see information on a license: 1. In the left-hand pane of the main WlmAdmin window (Figure 50), click the + (plus) sign to the left of a license server to see what licenses it is servicing. (Once you have expanded the license server information, you can click the (minus) sign to collapse the information again.) If a license server does not have a + (plus) sign next to it, it does not currently have licenses installed. 2. Click the name of a license. In the right-hand pane of the display you see information on the characteristics of the license. The exact information you see depends on the license. In addition to basic information, such as how many concurrent users can use the license, when it expires, and what users currently are using the license, the display can include whether the license can be used for commuter licensing, and if the license is a redundant license or a capacity license. If the license is a redundant license, you will see how its tokens are distributed and what license servers can service it. 3. Double-click a license to see if any users are using the license. (Once you have expanded the license information, you can click the (minus) sign to collapse the information) Tip: If a user symbol is red, that user is in a queue waiting for an available license. Exiting WlmAdmin To leave WlmAdmin, go to the File menu and select Exit. May 29, 2018 Page 47

49 Part VI - FAQs and Troubleshooting for Installation, Licensing, and Program Errors Issue - MARS installs in a local folder other than C:\MARS. Answer Unless the user intends for MARS to be installed in a location other than the default C:\MARS, uninstall the program and then manually remove the remaining contents of the install folder. Re-run the installer by right-clicking on setup.exe and using the Run as administrator option. Issue - When MARS opens, some of the tools/buttons on some tabs may appear different than the Help File shows. Answer On smaller displays - especially some laptops and monitors less than 20" diagonally that have traditional 4:3 aspect ratios - the tab labels will be closer together and some tools may change button/icon appearance. Note the example below for the two tools at the far right side of the Cross- Section/Profile tab. This is a problem with Microsoft Visual Studio and, ideally, it will be addressed in future releases of Visual Studio. If icon and/or labeling text disappears (as in the example above), tool-tip pop-ups will be enabled when hovering over those buttons, as shown below. Clicking an unlabeled button will present the options for that button. Always maximize the MARS program window to allow as much space for icons as possible. May 29, 2018 Page 48

50 Issue - When MARS opens, many of the tools are not available (buttons are grayed out). Answer Not all tools and functions are available at all license levels. Click on About MARS on the Help tab to see what License Type is authorized. A Production license has the most functionality, then Explorer QC, Explorer, Academic, Evaluation, and finally FreeView with the least. The 30-day Evaluation version of MARS offers the same tools as Explorer with a few exceptions. The Academic version offers the same tools as Explorer with a pre-defined time limit (typically 120 days or one academic semester). Issue The license type for MARS should be Evaluation, Academic, Explorer, Explorer QC, or Production, but MARS reports the License Type as FreeView. Answer For a standalone installation, the license file must reside in the main MARS installation directory which, by default, is C:\MARS. Only one license file should exist in this directory, and the file must be named either lservrc (no extension) or license.xml depending on the type of license in use. For a network server installation, the license file must be named lservrc (no extension), and it must reside in one of the following directories, depending on the operating system type (32-bit or 64-bit, respectively): C:\Program Files\Common Files\SafeNet Sentinel\Sentinel RMS License Manager\WinNT -or- C:\Program Files (x86)\common Files\SafeNet Sentinel\Sentinel RMS License Manager\WinNT Again, only one license file should exist in the applicable directory on the license server computer. Client computers must not have a license file installed on them. Also, the client computer(s) must have a System Environment Variable set that points to the computer acting as the License Server. Please check the section titled Client Configuration Environment Variables for more details. Finally, make sure that the license server computer is running and available to the network it should May 29, 2018 Page 49