FLEXid Driver Installation Instructions Version 2.1

Transcription

1 FLEXid Driver Installation Instructions Version 2.1

2 TABLE OF CONTENTS Overview... 3 Understanding Flexid Devices... 3 Running FLEXIdDriverInstaller.exe... 4 Supported Command-Line Options... 4 FLEXid Device Support... 5 Uninstalling... 6 Mac OS Platforms... 6 Linux Platforms... 6 Testing the FLEXid Installation... 7 Issuing FLEXnet Licenses... 7 Additional Information... 9 FLEXid Dongle Support... 9 Contacting Technical Support Copyright

3 Overview OVERVIEW FLEXid devices, also referred to as dongles, are serialized hardware keys used to lock software access to the machine on which it is physically installed. It works in conjunction with FLEXnet Licensing as a form of a hostid just like an ethernet address can be a form of a hostid. You supply your end user with the appropriate FLEXid hardware devices and drivers. If you choose to incorporate the FLEXid hostid type into your licensing model, you need to do the following: Decide on the specific type or types of FLEXid dongles you want to support based on the platforms on which you deploy your FLEXenabled application. See Table 1 for a list of supported FLEXid types. Ship the appropriate FLEXid driver installer along with installation instructions to your end user. See Installation Instructions for suggested installation instructions. Ship a quantity of FLEXid dongles to your end user. Dongles are obtained only through Macrovision; dongles obtained directly from the manufacturer will not function as FLEXnet Licensing hostids. Issue a FLEXnet license locked to the specific FLEXid dongles you shipped to your end user. See Issuing FLEXnet Licenses for more information. This document provides support information and installation instructions for the FLEXid wrapper and the FLEXid drivers included with the FLEXnet Licensing toolkit. Understanding Flexid Devices FLEXid devices or dongles provide the ability to bind a FLEXnet licensed application to a specific machine. Dongles can be found either on a parallel port or a USB port, and it is far more common to bind the client machine as opposed to the license server. Figure 1 below shows a client machine s encrypted license file being checked in and checked out from the FLEXnet License Server. Figure 1: Encrypted license file being checked in/checked out from FLEXnet License Server 3

4 Running FLEXIdDriverInstaller.exe RUNNING FLEXIDDRIVERINSTALLER.EXE If you run FLEXId_Dongle_Driver_Installer.exe in full UI mode, it will complete the following tasks: 1 Display a welcome dialog. 2 Check to see if older versions of the drivers are installed. If previous drivers are found, it will run a process to uninstall traces of any older drivers. Once the uninstall is complete, it will prompt for a reboot. 3 Restart itself after the reboot and display a post-reboot Welcome dialog. 4 Display a panel for the user to select version (types) 6_7 or 8 or 9 of the drivers. The user has the option of selecting one or more of the drivers. Based on the selection it will install the appropriate driver versions. 5 Prompts for a reboot at the end of the process. Supported Command-Line Options The following command-line options are supported: /silent Will run in UI mode; does not display any dialogs or UIs except for a reboot dialog when a reboot is required after the cleanup utility has been run. /update Will run only if there are older versions of drivers or partially installed drivers that need to be updated. If run on a clean machine with no traces of dongle drivers, setup will exit. /noreboot If this is passed and a reboot is required after the cleanup utility is run, it will NOT display the reboot dialog and create a registry entry under the following registry entry. This is primarily for users who want to include this setup within their own master setup and control machine reboot from the parent process. Key: HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\RunOnce Value: DongleDriverWrapper 4

5 Running FLEXIdDriverInstaller.exe FLEXid Device Support The table below lists the FLEXid devices supported in FLEXnet Licensing. These devices are availably only through Macrovision. Operating System FLEXnet Licensing Platform Hostid Keyword Manufacturer/Device Mac OS X v10.1 ppc_mac10 FLEXID=9 HASP 4 M1 USB memory key Microsoft Windows 32- bit, only: 98 Me i86_n3 FLEXID=6 (replaces FLEXID=7) Rainbow Technologies/SafeNet, Inc. Parallel-based ikey authentication token NT 2000 XP Server 2003 FLEXID=7 (no longer available, replaced by FLEXID=6) Rainbow Technologies/SafeNet, Inc. Parallel-based ikey authentication token FLEXID=8 Dallas Semiconductor/Maxim Integrated Products, Inc. 1- Wire parallel port adapter FLEXID=9 HASP 4 M1 USB memory key Red Hat Linux Version 7 and 8, 32-bit only i86_r6 FLEXID=9 HASP 4 M1 USB memory key Red Hat Linux Version 9, 32-bit only i86_r9 FLEXID=9 HASP 4 M1 USB memory key Red Hat Enterprise Linux Version 3, 32-bit only i86_re3 FLEXID=9 HASP 4 M1 USB memory key SuSE Linux Enterprise Server 8.1, 32-bit only i86_s8 FLEXID=9 HASP 4 M1 USB memory key 5

6 Running FLEXIdDriverInstaller.exe Uninstalling To uninstall drivers installed by this version of the FLEXid installer, select Macrovision FLEXid Drivers from Add/Remove Programs in the system s Control Panel. During installation, if a request has been made to install a driver that already exists from a non-macrovision source, that driver is not reinstalled. During subsequent uninstall requests, such drivers are not uninstalled. Only drivers that were installed by this version of the FLEXid installer are uninstalled. This is to guard against inadvertently uninstalling drivers that non- Macrovision software depends on. Consult %ProgramFiles%\Macrovision\FLEXid Drivers\install.log for a definitive list of drivers previously installed. Mac OS Platforms To install Flexid drivers on a Mac OS platform: 1 Locate the file HDD_Unified_Installer_sit.hqx in the platform folder of your FLEXnet Licensing toolkit installation. 2 Using StuffIt Expander or a similar utility, access the file s contents: aksusb_installer The driver installer README.txt Installation instructions 3 Following the instructions detailed in README.txt, invoke aksusb_installer to proceed with the installation. Linux Platforms Locate the instructions below specific to your Linux platform. You must be superuser (root) in order to install these components. Red Hat Linux, version 7 To install FLexid drivers on Red Hat Linux version 7: 1 Locate the file HDD_Linux.tar.gz in the platform folder of your FLEXnet Licensing toolkit installation. 2 Using the gzip and then tar utilities, access the file s contents. 3 Follow the instructions detailed in the file, INSTALL, to install both the kernel-mode driver, aksparlnx.o, and the daemon, aksusbd. Red Hat Linux, Version 8, 9, and Enterprise 3 To install Flexid drivers on Red Hat Linux version 8, 9, and Enterprise 3: 1 Locate the file aksusbd-redhat i386.rpm in the platform folder of your FLEXnet Licensing toolkit installation. 6

7 Running FLEXIdDriverInstaller.exe 2 Use the package manager utility rpm to install the driver: rpm -i aksusbd-redhat i386.rpm. SuSE Linux Enterprise Server 8.1 To install FlexId drivers on SuSE Linux Enterprise Server 8.1: 1 Locate the file aksusbd-suse i386.rpm in the platform folder of your FLEXnet Licensing toolkit installation. 2 As superuser (root), use the package manager utility rpm to install the driver: rpm -i aksusbd-suse i386.rpm. Testing the FLEXid Installation You can verify the FLEXid driver installation by following these steps. 1 Make sure to restart your system after the installation is complete. 2 Install the appropriate dongle onto your machine. 3 From a command prompt, run the lmhostid utility: lmhostid flexid. 4 Verify that a legitimate value is returned. The output should look something like the following: Lmhostid Copyright by Macrovision Corporation. All rights reserved. The FLEXnet Licensing host ID of this machine is FLEXID=9-0abcd123 The hostid corresponding to the FLEXid dongle in this example is 9-0abcd123. Use this value any place a hostid can be specified. Issuing FLEXnet Licenses Each FLEXid dongle has a unique identification number. The unique identification number is the value to which the FLEXnet license is locked. To determine the FLEXid dongle identification number, use the FLEXnet Licensing utility, lmhostid: 1 Attach the dongle to the machine. 2 Issue the following at a command line prompt: lmhostid flexid This returns the unique identification number of the dongle. A value is returned for each dongle attached to the machine. Use this value any place a hostid can be specified. FLEXid hostids can be used in SERVER lines and FEATURE/INCREMENT lines. 7

8 Running FLEXIdDriverInstaller.exe SERVER Line Usage The following shows how a FLEXid hostid would appear in a SERVER line. This is used for concurrent licensing models to control on which machine the license server system can run: SERVER myhost FLEXID=8-5E F7 This locks the server system to the machine that has a FLEXid dongle of type 8 with id of 5E F7. FEATURE/INCREMENT Line Usage The following shows how a FLEXid hostid would appear in a FEATURE or INCREMENT line template. This is used for nodelocked license models. FEATURE f1 benzd dec-2000 uncounted HOSTID=FLEXID=8-5E F7 SIGN=0 INCREMENT f2 wild oct-2003 uncounted HOSTID=FLEXID=6-1234ABCD SIGN=0 8

9 Additional Information ADDITIONAL INFORMATION FLEXid Dongle Support The table below lists those operating systems for which FLEXid dongle support exists along with a link to the appropriate installer. Download all installers appropriate to your implementation. Each installer contains all FLEXid dongle drivers supported by the particular platform. Operating System Mac OS X v10.1 Installer Name HDD_Unified_Installer_sit.hqx Microsoft Windows 32-bit only: 98 Me NT 2000 XP Server 2003 FLEXidDriverInstaller.exe NEW! Aladdin HASP Device Driver Commandline Installation for use with Microsoft Windows XP Service Pack 2. Red Hat Linux Version 7, 32-bit only Red Hat Linux Version 8, 9, and Enterprise 3, 32-bit only SuSE Linux Enterprise Server 8.1, 32-bit only Aladdin Driver version 4.96 Download HDD_Linux.tar.gz aksusbd-redhat i386.rpm aksusbd-suse i386.rpm 9

10 Additional Information Obtaining FLEXid Dongles Locate your required operating system in the table below to determine FLEXid dongle support information for that platform. Note the corresponding part number when ordering dongles. Ordering Information FLEXid dongles are purchased by publishers directly from Macrovision for distribution to their end users. End users need to purchase the dongles from their publisher. U.S. and APAC customers: To place an order, our Orders Department or fill out the order form here. EMEA customers: To place an order, our U.K. Orders Department or fill out the order form here. Operating System Manufacturer and Device Macrovision Part Number FLEXnet Licensing Requirement Mac OS X v10.1 HASP 4 M1 USB memory key FLEXid-ALA-7200 FLEXlm version 9.5 FLEXnet Licensing version 10.1 or later Microsoft Windows 32-bit only: 98/Me/NT/ 2000/XP/ Server 2003 Rainbow Technologies/SafeNet, Inc. Parallel-based ikey authentication token Dallas Semiconductor/Maxim Integrated Products, Inc. 1-Wire parallel port adapter FLEXid-RBW-7040 FLEXlm version 7.0 or later FLEXid-DAL-7021 FLEXlm version 5.0 or later HASP 4 M1 USB memory key (except NT) FLEXid-ALA-7200 FLEXlm version 7.2 or later Red Hat Linux Version 7 and 8, 32-bit only Red Hat Linux Version 9, 32-bit only Red Hat Enterprise Linux Version 3, 32-bit only HASP 4 M1 USB memory key FLEXid-ALA-7200 FLEXlm version 9.5 FLEXnet Licensing version 10.1 or later SuSE Linux Enterprise Server 8.1, 32-bit only Contacting Technical Support If you have any questions or problems, please contact the appropriate Technical Support group. 10

11 Copyright COPYRIGHT NOTICE OF COPYRIGHT AND OWNERSHIP OF RELEASE NOTES: Copyright (c) , Macrovision Corporation. All Rights Reserved. This README is the property of Macrovision Corporation of Santa Clara, California, U.S.A. Any use, copy, publication, distribution, display, modification, or transmission of this README in whole or in part in any form or by any means without the prior express written permission of FLEXid Driver Installation Instructions Version of 8 Macrovision Corporation is strictly prohibited. Except when expressly provided by Macrovision Corporation in writing, possession of this README shall not be construed to confer any license or rights under any of Macrovision Corporation's intellectual property rights, whether by estoppel, implication, or otherwise. ALL COPIES OF THIS README, IF ALLOWED BY MACROVISION CORPORATION, MUST DISPLAY THIS NOTICE OF COPYRIGHT AND OWNERSHIP IN FULL. 11

12 Macrovision Corporation 2830 De La Crux Boulevard, Santa Clara, CA US Int l +44 (0) Copyright 2006 Macrovision Corporation and/or Macrovision Europe Ltd. All Rights Reserved. Macrovision, InstallShield, and InstallScript are registered trademarks or trademarks of Macrovision Corporation in the United States of America and/or other countries. All other brand and product names mentioned herein are the trademarks and registered trademarks of their respective owners.