MARS V2017.2 Licensing And Installation Guide - Merrick

Locking Code Discovery Instructions forStandalone (Keyed or Keyless) or Network - Permanent LicenseIntroductionThere are three possible licensing configurations for a ‘Permanent’ MARS installation: Standalone(Keyed), Standalone (Keyless), or Floating Network. Standalone (Keyed) uses a USB hardware keythat allows any computer it is plugged into to acquire the MARS license. Standalone (Keyless) isnode-locked to one specific computer and cannot be transferred to another. Floating Network uses acomputer on the user’s network as a license server, and client computers on the same network canacquire a license without needing a hardware key. The Floating Network method also allows acomputer - typically a laptop - to commute (borrow) a license and disconnect from the network foroff-site use.This section provides instructions for determining the locking code(s), using SafeNet’s Wechoidutility, for all three methods. Once identified, these locking codes will be used to generate apermanent MARS software license. The license will authorize the appropriate MARS functionsdepending 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 Managersoftware for Network setups. Please read the entire section before beginning.NOTE** - For a first-time Standalone (Keyed) installation, Merrick & Company will deliver the USBhardware 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) DownloadRemove the Sentinel USB hardware key from the target computer if switching from Keyed toStandalone (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 willcause a Windows status message to be displayed in the notification area of the taskbar. If the driveris properly installed, the computer will automatically recognize the USB hardware key. If the key isnot recognized by Windows, download, unzip, and install the Sentinel System Drivers, accepting alldefaults. A reboot may be required after the driver installation. Go to Step 3A (Page 12).August 31, 2017Page 11

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 hardwarekey, 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 (examplebelow, *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 codeAugust 31, 2017Page 12

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 theboxes 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 toStep 4 (Page 15).Figure 12: Wechoid dialog – Ethernet Address locking codeAugust 31, 2017Page 13

Step 3C: Determine Locking Codes for Network ConfigurationUnzip 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 allof 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 codeAugust 31, 2017Page 14

To determine the secondary locking code, uncheck all of the boxes within the ‘Wechoid’ displayexcept for the ‘IP Address’ option (Figure 14). With the ‘Selector’ value displaying ‘0x2’, documentthe 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 codeStep 4: Send Locking Code(s) to Merrick & CompanyOnce the user has determined the primary and secondary locking codes (Network configuration), orthe single locking code of the Sentinel USB hardware key (Standalone Keyed configuration), or thesingle locking code of the target computer (Standalone Keyless Configuration), please send them toMark Stucky (mark.stucky@merrick.com), 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 isprinted on the side of the key housing beginning with the text ‘S/N:’.August 31, 2017Page 15

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 SoftwareIn order to configure the server computer’s environment to support network licensing, pleaseperform the following steps to set up the Sentinel RMS License Manager server.a: Download and Install Sentinel RMS License Manager softwareUsing the following link, please copy the Sentinel RMS License Manager Installer software shownbelow to the server computer. If prompted, navigate to the desired local directory and click ‘Save’ tocopy the file locally.1. Sentinel RMS License Manager Installer.zip (9.0 MB) DownloadUnzip the file locally and double-click the file named ‘setup.exe’ to launch the software installationprogram. 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 (dependingon whether the server is running a 32-bit or 64-bit version of Windows, respectively) on the servercomputer hosting the Sentinel RMS License Manager, overwriting any existing ‘lservrc’ file.C:\Program Files\Common Files\SafeNet Sentinel\Sentinel RMS License Manager\WinNT-orC:\Program Files (x86)\Common Files\SafeNet Sentinel\Sentinel RMS License Manager\WinNTIf this exact path does not exist on the server computer, search the system to locate the installationdirectory 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 FunctionalityMatrix (available here).c: Stop/Restart ‘Sentinel RMS License Manager’ ServiceIn order for Sentinel to recognize and utilize the MARS network license file, the ‘Sentinel RMSLicense Manager’ service must be stopped and restarted on the server computer.August 31, 2017Page 16

To access the ‘Sentinel RMS License Manager’ service (Figure 15), please launch the ‘Services’ dialogby double-clicking the ‘Services’ option within the ‘Administrative Tools’ dialog. This dialog can beaccessed from the Control Panel (Start Control Panel).Figure 15: Windows Services dialogLocate the ‘Sentinel RMS License Manager’ service and select it by clicking on the service name. Tostop the service, right-click on the highlighted service and select the ‘Stop’ option or click the ‘StopService’ buttonnear the top of the dialog’s interface. The following dialog (Figure 16) will bedisplayed until the service has completely stopped.Figure 16: Service Control dialog – stopping a serviceTo restart the ‘Sentinel RMS License Manager’ service, right-click on the highlighted service andselect the ‘Start’ option or click the ‘Start Service’ buttonnear the top of the dialog’s interface.The following dialog (Figure 17) will be displayed until the service has completely started.August 31, 2017Page 17

Figure 17: Service Control dialog – starting a serviceStep 6: Install MARS client softwarePlease refer to Part II – Installation beginning on Page 19 in this guide to complete the MARS clientsoftware installation on all target computers. When installation is complete, return to this sectionand continue with Step 7 (Standalone), or proceed to Part III – Post-Installation (Network) on Page34.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 iconAugust 31, 2017Page 18

Part II – MARS Software InstallationIntroductionThis section provides instructions for first-time installation or in-place upgrade of the version 2017.2MARS software suite and sample data on client machines. Please fully read this section beforestarting the MARS installation procedure.Step 1: Install MARS on Client Computer(s)Using Windows (File) Explorer, navigate to the downloaded MARS installation package and extractits contents to a local drive. When completed, find the MARS installation executable (setup.exe) inthe newly-extracted folder as displayed in Figure 19 (the exact folder contents may vary from thegraphic). Begin the MARS software installation by double-clicking the ‘setup.exe’ file. Note that onsome 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 pageswill appear during an in-place upgrade. Typically, the first pop-up will be as shown in either Figure 26or 27 (Page 23). 2. Any existing “MARSBreaklineProperties.xml” file will be migrated from the oldinstallation folder to the new one.NOTE: If at any point during the following Microsoft Visual C Runtime installation a prompt for areboot appears, accept it and run “setup.exe” again (see above) to continue with the MARS installation.August 31, 2017Page 19

Immediately following the launch of the MARS installation executable, the following dialog will bedisplayed as the Windows Installer software scans the computer hard drive for system resources(Figure 20).Figure 20: Windows Installer dialogFollowing this window, the Microsoft Visual C 2010 Runtime installation will begin (Figure 21),unless that component already exists on the computer. Click ‘Install’ to continue.Figure 21: Visual C 2010 Runtime installation dialogA progress bar screen (Figure 22) will appear, followed by the license terms screen (Figure 23). Checkthe acceptance box and then click ‘Install.’August 31, 2017Page 20

Figure 22: Visual C 2010 Runtime installation progress barFigure 23: Visual C 2010 Runtime license termsInstallation will then begin for this Windows component (Figure 24), followed by a completion screen(Figure 25). Click ‘Finish’ to continue with installation.August 31, 2017Page 21

Figure 24: Visual C 2010 Runtime InstallationFigure 25: Visual C 2010 Runtime installation complete screenAugust 31, 2017Page 22

After the Microsoft Visual C 2010 Runtime installation has completed, the following dialog (Figure26) will be displayed to show the status of the MARS software installation.Figure 26: Windows Installer dialogNOTE for Windows 7 and later users: At this point, a ‘Program Compatibility Assistant’ window mayopen saying that there may be a problem with program installation. In our testing we have notdetected 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 dialogAugust 31, 2017Page 23

The user will then be prompted to accept the MARS end-user license agreement (Figure 28). Tocontinue 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 dialogIf the user chooses not to accept the license agreement, the MARS software installer will close andthe installation process will terminate.August 31, 2017Page 24

The user will then be prompted to define the MARS installation directory within the ‘Folder:’ textbox 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 shownbelow.Figure 29: MARS installation dialogClick ‘Next ’ to continue with the software installation.August 31, 2017Page 25

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 dialogAugust 31, 2017Page 26

During the MARS software installation, the following installation status dialog (Figure 31) will bedisplayed.Figure 31: MARS installation status dialogAugust 31, 2017Page 27

MARS software users have the opportunity to navigate around the program and try out the varioustools and functions using a sample data set. The MARS sample data folder includes the followinggeospatial data files (plus some auxiliary files): LiDAR (LAS) DataOrthophotographyTile SchemeGround Check PointsCompiled BreaklinesMetadataMARS Sample LiDAR.lasMARS Sample Digital Camera Image Mosaic.ecwMARS Sample Project Tiles.shpMARS Sample Check Pts.csvMARS Sample Breaklines.shpSample Dataset Metadata.txtThe sample data will be automatically extracted and copied into the MARS ‘Sample Data’ folderduring the installation process, as shown in the ‘Destination folder’ box (Figure 32). On somesystems, this window will remain hidden behind the installation progress window shown on theprevious page (Figure 31). Once complete, the sample data folder size will be approximately 277 MB.Figure 32: MARS sample data extraction status dialogAugust 31, 2017Page 28

Vertical transformation files – used for converting vertical datums and/or height models from onesystem 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 filesbefore continuing with the installation. In the case of an upgrade, a check will be made in the installpath to see if existing vertical files are current. If so, installation will continue normally. If they arenot current, the prompt in Figure 33 will appear. Depending on connection speed, this process maytake 15-30 minutes. Once started (Figure 34), the download can be canceled and the vertical filespackage 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 reaches100% 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 inthe folder when complete so that MARS can check the status of the files during future updates.Figure 33: Download vertical files promptFigure 34: Vertical files download progressAugust 31, 2017Page 29

NOTE: If a pop-up appears asking whether an existing file named ‘MARS QAT.xml’ should bereplaced, the answer will depend on whether the MARS Quick Access Toolbar has been customizedsince the last install/upgrade. This file holds information about the Quick Access buttons and theirorder of appearance – by default, 10 buttons are initially included. If no customizing has been done tothe toolbar buttons, answer ‘Yes’ and allow the installer to put the latest version of the file in theinstall folder, overwriting the existing one. Otherwise, answer ‘No’ to keep the existing version of thefile. The pop-up may be hidden behind the installation window.NOTE: If a pop-up appears asking whether an existing file named “geodata 72.xvw” should bereplaced, the answer will depend on whether any custom coordinate systems have been created inGeoEdit, which would have created a new “custom.xml” file and modified the existing“geodata 72.xvw” file. If new systems were created, any “custom.xml” file will be migrated from theold installation folder to the new one, and the existing “geodata 72.xvw” should be kept to ensurethat 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 minormodification to the “geodata 72.xvw” file if the original version is kept. Note that the pop-up maybe hidden behind the installation window.It is highly recommended the most current video driver be loaded on the workstation for stability andoptimum rendering of data. Please check for current video drivers on the computer or graphics cardmanufacturer’s website. The following dialog (Figure 35) will be displayed during installation toremind users to update their video driver, if necessary. The installation routine will not automaticallyupdate any video drivers. Click ‘Next ’ to continue with the MARS software installation.Figure 35: Video driver update messageAugust 31, 2017Page 30

To obtain optimum video playback when using the Video Hyperlink Playback tool in MARS , pleasedownload and install the video CODEC (COde/DECode) package

August 31, 2017 Page 5 Step 4: Launch MARS To launch the MARS software application, click Start All Programs MARS MARS or double- click 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,