RLM Activation Pro Manual
Total Page:16
File Type:pdf, Size:1020Kb
RLM Activation Pro Manual RLM v14.1 July, 2020 RLM Activation Pro Manual Page 1 of 120 RLM Activation Pro Manual V14.1 RLM Documentation - Copyright (C) 2006-2020, Reprise Software, Inc RLM - Reprise License Manager - Copyright (C) 2006-2020 Reprise Software, Inc RLM Activation ProTM Reprise License Manager TM Copyright © 2006-2020, Reprise Software, Inc. All rights reserved. Detached Demo, Open Usage, Reprise License Manager, RLM Activation Pro and Transparent License Policy are all trademarks of Reprise Software, Inc. RLM contains software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org) Copyright (c) 1998-2008 The OpenSSL Project. All rights reserved. Copyright (C) 1995-1998 Eric Young ([email protected]) All rights reserved. RLM contains software (the GoAhead WebServer) developed by GoAhead Software, Inc. The rlmid options contain copyrighted materials as follows: rlmid1 devices are manufactured by Aladdin Knowledge Systems, Inc. (SafeNet, Inc.) RLM Activation Pro Manual Page 2 of 120 Table of Contents Welcome ................................................................................................................ 4 What's New in RLM Activation PRO v14.1 ........................................................ 5 Section 1 – RLM Activation Pro Basics ............................................................... 6 Activation Overview............................................................................................. 7 Activation Use Cases .......................................................................................... 10 Activation Pro Setup .......................................................................................... 14 Your Activation Database................................................................................... 15 Product Definitions ......................................................................................... 17 Activation Keys ............................................................................................... 24 Activation Key Types.................................................................................. 29 Other RLC Commands ...................................................................................... 33 Fulfillments ..................................................................................................... 33 Customer List ................................................................................................. 34 Reports ............................................................................................................ 36 Admin .............................................................................................................. 36 Enabling Your Application for Activation ....................................................... 43 Reporting ............................................................................................................. 46 Release Checklist ................................................................................................ 50 Reseller Support ................................................................................................. 51 Customer Portal ................................................................................................. 53 Setting Defaults for Products and Activation Keys ........................................ 55 Section 2 – Advanced Topics ….......................................................................... 58 Activation Pro Setup (local server) .................................................................. 59 Upgrading from an earlier version of Activation Pro .................................... 65 Section 3 – Reference Material …....................................................................... 66 Appendix A – Activation API ........................................................................... 67 Appendix B – Example Program ....................................................................... 68 Appendix C – License Rehosting ........................................................................ 73 Appendix D – Activation Database …................................................................ 83 Appendix E - Frequently-Asked Questions …................................................... 93 Appendix F – Document Revision History..........................................................94 Appendix G – Diagnosing Activation Problems..................................................96 Appendix H – Redirecting Your Activation Website..........................................103 Appendix I – Automatically Blacklisting IP addresses.......................................104 Appendix J – How Activation Pro chooses a hostid............................................105 Appendix K – Using custom license generators...................................................107 Appendix L – Bulk Loading Customer Data.......................................................109 Appendix M – Customizing the Customer Data..................................................110 Appendix N - Importing Activation Keys to ActPro...........................................111 Appendix O - Using Web Services to Access the ActPro Database...................112 Appendix P – Upgrading to Actpro v12.4 or later ….........................................117 Appendix Q – Basic License Enforcement Using Web Services …...................118 Appendix R – Loading Customer Data from your Activation Utility ..............120 RLM Activation Pro Manual Page 3 of 120 Welcome This manual, the RLM Activation Pro Manual, is intended for organizations that have licensed the optional RLM Activation Pro software or the Hosted Activation Service from Reprise Software. This manual explains how to configure and run the activation software. The RLM documentation is divided into 5 manuals: Standard RLM Components RLM Getting Started Guide - an introduction to the basic concepts of license management and RLM RLM Reference Manual - the complete reference to all core RLM components RLM License Administration Manual - The License Administration manual, suitable for shipment to your customers Optional RLM Components RLM Activation Pro Getting Started Guide – An Introduction to the RLM Activation Pro software RLM Activation Pro Manual (this manual)- Reference for the Optional RLM Activation Pro software All five manuals are available at the Reprise Website: http://www.reprisesoftware.com/kits/RLM_Getting_Started_Guide.pdf http://www.reprisesoftware.com/kits/RLM_Reference.pdf http://www.reprisesoftware.com/kits/RLM_License_Administration.pdf http://www.reprisesoftware.com/kits/RLM_Activation_Pro_Getting_Started_Guide.pdf http://www.reprisesoftware.com/kits/RLM_Activation_Pro.pdf Table of Contents RLM Activation Pro Manual Page 4 of 120 What's New in RLM Activation PRO v14.1 This section lists the new features in RLM Activation Pro v14.1 along with pointers to the relevant sections in the manual. NOTE: Before upgrading Activation Pro to v14.0 or later, please read Appendix P – Upgrading to Actpro v12.4 or later on page 117 If you fail to do this, your upgraded system may not work. What's new • Activation Pro now supports HTTPS transport on Windows, Linux, and Mac. See the Reference Manual “Using RLM with HTTPS” chapter for details. • The debuglog can now be displayed in chronological or reverse chronological order. • The debuglog no longer logs all entries in the blacklist. These can be seen in the “blacklist” tab. • The new RLM_ACT_DIAGNOSTCS environment variable causes activation diagnostics to be written to a file. See Appendix G – Diagnosing Activation Problems on page 96 for more information. • There is a new report to display disabled activation keys. • You can now upload your logo to activation pro, and it will replace the Reprise logo. See the Admin Database Tab on page 37 for more information. • On hostedactivation.com and aNNN.hostedactivation.com, the debuglog table will be purged every night of data that is > 14 days old. This applies to hosted activation sites only. • The Admin->Delete Revoked tab now allows you to delete all revoked licenses, including revoked permanent licenses. • The product definition table now includes a displayorder column, which controls the order of products presented in the choicelist when you create an activation key. See Product Definitions on page 17 for more information. • The user_def column in the keyd table is now 32 characters. This data is unused by activation pro. • The login inactivity timeout has been changed from 10 minutes to 2 hours. API changes • Table of Contents RLM Activation Pro Manual Page 5 of 120 Section 1 – RLM Activation Pro Basics This section of the manual contains the information you need to set up and deploy the RLM Activation Pro software. RLM Activation Pro Manual Page 6 of 120 Activation Overview Overview RLM Activation Pro allows you to deliver a pre-generated activation key to your customer, and when they are ready to use your product, a transaction with the activation server running at your site allows the license to be fulfilled without manual intervention. When using activation, there is no need for you to get your user's hostid information - this is transmitted to the activation server automatically. In the case of a node-locked product, a typical scenario would be that your customer runs the product on the desired machine, and if the license had not been fulfilled earlier, the product asks for an activation key. Once the