Home
RLM Activation Pro Manual
Contents
1. Records 1 to 4 of 4 displayed Items to display 20 This list gives you an overview of the product definitions in your Activation Pro system If any product definition has no associated activation keys defined you can delete it by pressing the red X in the far right hand column In this example test product 2 and test product 3 have no activation keys defined so they can be deleted Note that you can control the number of product definitions displayed by changing the Items to display count at the bottom of the screen You can also filter the list by entering text in the Select text boxes at the top of the screen If the list is longer than the number of items to display RLC will display a pagination box at the end of the list like the following Records 1 to 20 of 104 displayed Pahes 12 34 5 6 Items to display 20 The list filtering and pagination are common to all the browsers View Product Definitions View Activation Keys View Fulfillments and View Customers Activation Keys If you are going to use RLM Activation Pro you will then need to create activation keys these are the keys you give to your end users When they have the activation key they can then use Activation Pro to fulfill licenses for their products Activation keys can be set up to allow unlimited use or a fixed number of uses Activation keys consist of an activation type a product definition name to be ful
2. forms You can page through the various pages as well as sort on the columns by clicking on the underlined column header If you selected either tab or comma delimited output you will see the a screen similar to the following RLM License Center RLM Activation Pro Copyright c 2006 2011 Reprise Software Inc All Rights Reserved Activation Report Generator Activation Keys 1104 Records output Click here to download report When you click on the underlined Click here to download report your browser will ask you if you want to save the file with a dialog similar to the following Firefox shown here Opening actpro report 7PGepl ES You have chosen to open E actpro report 2PGgpL which is a Text Document From http macmini What should Firefox do with this File Open with scalc exe v Save File C Do this automatically For files like this From now on Cancel You can either open the file directly with your spreadsheet or save the file Once opened the standard spreadsheet import functions for tab or comma delimited files will work to put your report data into separate columns RLM Activation Pro Manual Page 33 of 68 Release Checklist With RLM Activation Pro you control the activation server so you can make changes at any time However there are a couple of issues that you need to consider before you ship your application Review the rkn activate or rlm act request call
3. sisssensss 17 Ch nt Setup esee tke neos evi erra eain a eoe ON E EReN NER VS S FR EVESREY ERES EST EE Oa SEE Sa EN SES eR EE UE 30 Reporting d 32 Release toWdicem c scossa snosio kassas sorisa Sie 34 Importing Activation Keys to ActPro ssseesessessesesseseesesorseeeesoreororeoeoeesesenseeorsee 35 Appendix A Activation API eeeeeeeeee eee eene eese etes tnn eene s etna tn seen stus enun 37 Appendix B Example Program eeeeeeeeee eese eene esee n etes tn sanae sentina 38 Appendix C License Rehosting 4 eeeeeeeee eee eese eene entente nennen stnae 41 Appendix D Activation Database eeeeeeeee eee essent nete tenen stus etn stnnin 47 Appendix E Upgrading from RLM Internet Activation 54 Appendix F Frequently Asked Questions sssssssssssscssssssssssessessessesseees 55 Appendix G Document Revision History eese eee eee entente 56 Appendix H Diagnosing Activation Problems eeeereeee ener 57 Appendix I Refresh type activations deprecated esee 62 Appendix J Redirecting Your Activation Website eee 65 Appendix K Automatically blacklisting IP addresses ess 66 Appendix L How Activation Pro chooses a hostid eres 67 RLM Activation Pro Manua
4. GENERATE Activation Keys s The Activation type is one of the following Normal e Reactivate Refresh deprecated in RLM v9 3 The meaning of these 3 types is described below The product name is the name of the product definition to be activated The of fulfillments is the number of fulfillments allowed by this activation key For Refresh keys this is always 1 and even if you enter a larger number rlc stores the count as 1 The meaning of count depends on the type of fulfillment see below The of rehosts allowed is used for the Refresh fulfillment type only This count is the number of times a hostid can be changed while this activation key is valid After this number of hostid changes licenses can only be refreshed for the last hostid RLM Activation Pro Manual Page 23 of 68 The of activation keys to create controls how many activation keys are created with the data in this form If the key string is specified see below this exact key will be used if the of activation keys is 1 If the of activation keys is gt 1 then the key string will have a 16 digit string appended for each unique activation key generated The Allowed domains whitelist is a space separated list of domain names which are allowed to activate using this activation key If a request comes in from another domain it is rejected with RLM ACT NOT WHITELISTED Note that the names in this list can be a substring of the hostname requesting t
5. RLM Activation Pro Manual Page 29 of 68 Client Setup In order to set up activation you do 3 things 1 install the Activation Pro software on your webserver described in the Activation Pro Setup chapter on page 12 Not necessary for Reprise Hosted Activation customers 2 setup the Activation Database described in the Database Setup chapter on page 17 3 Add activation request calls to your application described in this chapter On the client side you must prepare your activation code and get the activation key to your customer Making the activation request for your customer using the activation API Once you are familiar with how to use the activation server and the activation GUI you are ready to integrate the activation request into your application To do this embed a call to rlm_act_request at the appropriate point usually after attempting to check out a license which fails and if you are successful at activating the license perform the following steps e call rlm_close on your handle write out the activated license to a local license filename of your choice Reprise Software recommends a file named something lic call rlm init and e re attempt the license checkout For details on the activation API request call see Appendix A Activation API on page 37 Making the activation request for your customer using the activation GUI You can get started right away by using the activation GUI supp
6. column meaning data type akey the activation key string active 0 if this definition is inactive if active integer product id product identifier from product definitions integer count the of activations allowed 0 unlimited Limited to 1 for integer Refresh type activations type 0 Normal 1 Reactivate 2 Refresh integer rehosts For Refresh the number of hostid changes allowed integer lastdate Expiration date of activation key key cannot be used after string this date exp If a number number of days to expiration of the license string after product activation If 0 the license does not expire If a standard RLM date format it is a fixed expiration date If specified this expiration date overrides the expiration date in the product definition white Domain whitelist for key only domain names appearing in string 100 this list can use the key This string can be a space separated list If any component of the string matches the requesting hostname that host is allowed to activate using this key misc any optional RLM license attributes string 255 notes optional notes to allow you to identify the key unused by string 100 RLM keyf activation key fulfillment information one row per activation key This table is written by both the license generator and rlc Contents column meaning data type akey the activation key string n
7. e The hostid list can contain no more than RLM MAX HOSTID LIST 25 hostids This capability can be used to create a license which works on 2 or more systems e g to create a license for a primary and a backup system It can also be used to pass a hostid RLM Activation Pro Manual Page 67 of 68 of a less secure type to be used e g the hostid list list ip 172 16 7 12 will cause the activation software to use the IP address as a hostid without returning RLM ACT BAD HOSTID TYPE RLM Activation Pro Manual Page 68 of 68
8. if your username is joe and password is joes_password setenv HTTP_ PROXY CREDENTIALS joe joes_password Note that RLM activation supports only the BASIC authentication type You can either set these environment variables before running your application or use putenv or rlm_putenv to set them inside your application before calling r m_act_request RLM Activation Pro Manual Page 31 of 68 Reporting rlc contains a reporting module which allows you to generate reports of products activation keys fulfillments etc To use the reporting module select Reports from the menu on the left hand side of the page When you select Reports the first Reporting screen appears The first choicelist allows you to select the report type Activation RLM License Center RLM Activation Pro Keys Permanent Licenses Fulfilled Licenses Products Revoked Copyright c 2006 2011 Reprise Software Inc All Rights Reserved Licenses or Statistics On the second line you select the output for the report either directly to the browser or to a tab or comma Aivatian Rabar Acivalion Keys i delimited file which can be imported POI Dawelon REUS to a spreadsheet Report Output HTML to browser O tab delimited fle comma delmited file Activation Report Generator After making these selections click Select Report Parameters which will present a screen allowing you to filter the output of the report T
9. later expiration date some number of days from the reactivation date specified by the ISV Rehost and Refresh Concepts Note the REFRESH activation type has been deprecated in RLM v9 3 Please use the new rehostable hostid type if you wish to allow users to transfer licenses from one system to another A rehostable license is one that is intended to be reactivated frequently and receive a new expiration date with each reactivation Rehostable licenses are typically of very short duration The main purpose of the refresh activation type is to support rehosting of licenses Rehosting is when the end user wants to move a license from one system to another Traditionally the ISV had no way of knowing if the end user ceased running the application on the original system after issuing a license for the new system With very short term rehostable licenses the ISV is assured that the maximum period during which the end user can run the licensed application on both the old and the new systems is the short duration of the rehostable license Refresh type licenses must be node locked they can never be floating For example if the ISV specifies that the rehostable license for a product should expire 4 days after activation a rehost of that product will effectively shut off use of the product a maximum of 4 days after the rehost If the refresh operation at the end user site is run daily and it fails for some reason on a given day the license is
10. the blacklist is not used and the domain requesting the activation must be part of the allowed domains specification in the activation key itself Beginning in RLM v9 4 the license generator automatically blacklists IP addresses which attempt a large number of incorrect activation keys These ip addresses will appear in normal IP address format a b c d rather than as domain names and an exact IP address match is required to blacklist the address rather than the substring match that happens with manually blacklisted domain names When you are manually entering blacklisted domains do not enter them in IP address format You can delete any automatically blacklisted IP address in this list by pressing the delete icon on the right hand side of the list For more information on the automatic blacklisting of IP address see Appendix K Automatically blacklisting IP addresses on page 66 RLM Activation Pro Manual Page 26 of 68 Customer List RLM Activation Pro allows you to maintain a customer list and associate customers with activation keys You create customers with the Add Customer button in the Setup Command area near the top of the command list When you press Add Customer the company contact form appears RLM License Center RLM Activation Pro Copyright c 2006 2012 Reprise Software Inc All Rights Reserved Add New Customer Click ADD Company Info or Add Contact Person Info below to create the company or c
11. ES Server host hostedactivation com View Edit Blacklist Database Semerhost mysql1423 ixwebhosting com Database C207473 hosted demo Database size Mb 0 038 View Product Definitions RLM Activation Pro version v9 4BL0 p5 29 may 2012 Reprise Software Inc ViwFufilments ina Ae User adminj3d0 Access Admin Change Password Administer Users Administer Database il 1 user s logged in The command buttons are arranged in 3 groups top to bottom e Setup commands Create Product Definition Create Activation Key View Edit Blacklist and Add Customer Database viewing updating commands View Product Definitions View Activation Keys View Fulfillments View Customers Reports About rlc and Manual A Login area with some account modification and administration commands RLM Activation Pro Manual Page 18 of 68 Logging In At the bottom of the menu username and password boxes are displayed along with a Login button Enter the username and password assigned by your administrator when Activation Pro is installed an admin user is created with password admin Once logged in this area changes to a set of administration commands appropriate for the user The commands are Change Password Administer Users Administer Database and Logout Change Password allows you to change your password Note passwords can consist of numbers lowerc
12. NOT http www reprisesoftware com cgi bin RLM EH ACT BADSTAT 134 rim act request received no status in the returned message from ZSV mklic This is most likely a configuration error on the server side which causes the ZSV mklic process to return an incomplete reply The HTTP server error logs might well indicate the problem If your server is known to be running correctly this could be caused by a proxy server that isn t configured correctly This can also be caused by the Avast anti virus software which interrupts the return from the activation server and returns a partial buffer causing this error The workaround is to turn off the Avast Web Shield This can be turned off for 10 minutes in the Avast GUI RLM EH BAD HTTP with sub error equal to HTTP status 136 Other HTTP error See the full error message for the HTTP status Use RLM s extended error messages RLM EH UNLICENSED 143 RLM license keys missing or invalid Check your license to run h include file and ensure your RLM keys are valid RLM EH ACT OLDSERVER 145 Activation server version too old This happens when a pre v9 activation server is used with a v9 client which encrypts the request This can also happen if there is a proxy server installed at the user site RLM EH CANT CREATE REHOST 151 The rehostable hostid for this product could not be created Verify that the user has
13. RLM HANDLE const char int main int argc char argv RLM HANDLE rh RLM HANDLE NULL RLM LICENSE lic RLM LICENSE NULL int stat const char product actdemo int pass for pass 1 pass lt 2 pass if pass 2 We did not get the license on the first pass See if we can activate it now Ek Stat doactivation rh product rlm close rh Close the old handle if stet lt D exit 2 m NOTE that rlm init is in this loop This is necessary 2 because if the license is not acquired on the first pass ii the activation request above will create a new license file rlm init must be called to see this new license file A rh rlm init argv 0 char NULL stat rlm stat rh if pass 1 amp amp stat RLM EH READ NOLICENSE We didn t find a license Checkout won t work so just K skip to the 2nd pass where we try to activate it A continue else if stat void printf Error d initializing license system n exit 1 lic rlm_checkout rh product 1 0 1 stat checkstat rh lic product if pass 1 amp amp stat lt 0 Didn t get the license Try a 2nd time to activate it Ef if lic rim _ checkin lic lic RLM LICENSE NULL continue else if stat 0 d We got the license Xf break RLM Activation Pro Manual stat Page 42 of 68 if stat 0 We
14. The activation data consists of product and activation key definitions blacklisted host definitions rlc setup data as well as records of license fulfillments The data is described in the Activation Data section below and is all stored in a MySQL database The activation request API rlm activate or the older rlm act request allows you to embed activation requests within your application or your installation tools The optional activation GUI is built into the RLM webserver using the activtion request API to provide a generic activation user interface You will always be able to provide a simpler activation user interface to your customers by using the activation request API since you know the answers to many of the questions which the Reprise supplied activation GUI must ask However you can use the supplied activation GUI to get started without modifying your applications Rehostable Licenses Activation can be set up to support rehosting of licenses by the end user without ISV involvement This involves the use of the rehostable hostid type which is new in RLM v9 3 A rehostable hostid is requested at the time that rlm_activate is called and the activation server issues the license to this hostid Later 1f the user wishes to move this license to another system the rim revoke call can be used to revoke the rehostable license and allow it to be activated on another system Note that the rehostable hostid is a copy protected fi
15. c 2005 2012 by Reprise Software Inc This software has been provided pursuant to a License Agreement containing restrictions on its use This software contains valuable trade secrets and proprietary information of Reprise Software Inc and is protected by law It may not be copied or distributed in any form or medium disclosed to third parties reverse engineered or used in any manner not provided for in said License Agreement except with the prior written authorization from Reprise Software Inc OKCkCk kk k kk kCk kk kck kc k Ck k k Ck k kk k k kk k k k Ck k kk k k k ck k k k Ck k k ck k k k ck k k k Ck k k ck ck k ck ck ck k ck ck ck ck ck kck ck kckck kk k id Description Example client for RLM internet activation M Christiano 6 18 07 i Id RLM Activation Pro html v 1 2 2011 02 25 00 24 26 matt Exp zy include license h include lt stdio h gt include lt stdlib h gt include lt string h gt static int getstat RLM HANDLE RLM LICENSE const char int main int argc char argv RLM HANDLE rh RLM LICENSE Iiic int x stat const char product actdemo int loop 0 while loop 2 rh rlm init argv 0 char NULL if rh RLM HANDLE NULL void printf Error initializing license system n exit 1 lic rlm_checkout rh product 1 0 1 getstat checks the status and if bad tries an activation if the user requests it If the returne
16. com actpro setup Make sure that the actpro setup directory is mode rwx to the web user e Make sure that actpro setup rlmact mysql is writable by the web user RLM Activation Pro Manual Page 14 of 68 NOTE if you are going to host your servers at your ISP many ISPs have naming conventions for MySQL databases and in addition many ISPs will not allow you to Run the Activation Pro setup program On Windows Run the XAMPP control panel Start the Apache and MySQL services On Linux this happened as part of installation Point your browser Firefox recommended to http localhost actpro_setup setup php The defaults in the form should be correct so press Setup activation database REMEMBER the admin account username and password you will need this later The default is admin and admin create a new database from a script the way that Activation Pro s setup php software does it If this is the case simply create the database manually using your ISP s administration tools then run setup php after the database is created Security Considerations Once your Activation Pro software is installed you will want to check the permissions on all files and perform other security checks on your website While this list is not complete it is a good start Li Remove the directory actpro_setup on your webserver You no longer need this Change the modes of the following files as shown note the
17. demo applies to either standard Internet Activation or Activation Pro How Activation Works RLM Activation is driven by two main data items product definitions and activation keys The RLM License Center tool rlc allows you to define various products to be activated Product definitions consist of a product definition name a product name version expiration specification and node locked floating indication In addition product definitions can contain additional attributes for the license All product definition attributes are described in detail in the Database Setup chapter on page 17 Once a product is defined activation keys can be created An activation key specifies the product to be fulfilled the type of fulfillment and how many fulfillments are allowed by this activation key In addition activation keys allow you to specify the license expiration and or additional attributes for the license If any of the attributes specified in the activation key are the same as attributes specified in the product definition the activation key version of these attributes will be used All activation key attributes are described in detail in the Database Setup chapter on page 17 Once activation is set up you give your customer an activation key which they then use to retrieve the license for the particular machine which they are using This happens via the internet using the license generator isvname_mklic on your website The request is
18. f fopen stat 1 Write the license out for try 0 try lt 100 try sprintf name a d lic try f fopen name r if f FILE NULL f fopen name w if f fprintf f s n license fclose f RLM Activation Pro Manual 1 Page 39 of 68 break else printf Error writing license file s n name stat 1 break else printf un t switch stat case RLM EH CANTCONNECT URL printf You were unable to connect to http www reprisesoftware com n printf Please make sure that this system is able to n printf access the internet and try again n break case RLM ACT NO KEY printf The activation key you supplied s was Wn akey printf not found Please check the key and ensure n printf that you have entered it correctly Nin break case RLM ACT KEY USED printf The activation key you supplied s n akey printf has already been used to activate a license Mn printf Please check the key and ensure that you have entered it dotrectly Xn break case RLM ACT BAD HTTP printf HTTP error on activation server Mn break default printf Error Sd requesting activation n stat break prince Nn return stat RLM Activation Pro Manual Page 40 of 68 Appendix C License Rehosting Rehostable Licenses Activation can be set up to support rehosting of licenses by the end user wi
19. got the license E7 if lic rlm_checkin lic printf License valid n stat dodeactivation rh product rim close rh else if pass 2 checkout and or activation failed ui void printf Unable to check out activate actdemo license n return 0 static int checkstat RLM HANDLE rh RLM LICENSE lic const char name int doactivation RLM HANDLE rh const char name int stat char errstring RLM ERRSTRING MAX stat rlm license stat lic if stat 0 void printf Checkout of s license OK n name else void printf Error checking out s license n name void printf ss n rlm errstring lic rh errstring return stat include lt time h gt ifndef WIN32 include lt sys time h gt endif char license 3 RLM MAX LINE 1 Allow for HOST ISV and LICENSE char akey RLM MAX LINE 1 int stat RLM EH READ NOLICENSE If they say NO no license int len void printf nWould you like to activate this license now fgets akey RLM MAX LINE stdin if akey y akey Y void printf Enter Activation key for s name fgets akey RLM MAX LINE stdin len int strlen akey 1 if akey len n akey len 0 Request the license First make a handle and tell it we want a rehostable hostid to activate a Note you would normally never need to do this but we do it here
20. it is not appropriate for production see below While it is certainly possible for you to install Activation Pro on an existing Apache MySQL PHP stack please understand that Reprise cannot support every combination of these components We are familiar with the XAMPP stack and will be able to offer help on XAMPP We strongly urge you to install Activation Pro on an XAMPP stack to become familiar with the product then once you are familiar with RLM Activation Pro move your installation to you ultimate web server or web hosting company This way you will have a working reference implementation Note that XAMPP is not recommended for production installations it is not secure See here http www apachefriends org en xampp html 300 If you are not comfortable setting up your own webserver you might consider Reprise Software s hosted activation service which will save you the trouble of installing even XAMPP Setting Up Activation Pro To set up RLM Activation Pro there are 6 steps Install a pre configured Apache MySQL PHP AMP stack described in this chapter Install the Activation Pro software on your webserver described in this chapter Configure RLM Activation Pro described in this chapter Optional Configure your License Generator if you use an ISV defined hostid Setup the Activation Database described in the Database Setup chapter on page 17 Add activation request calls to your application or build a stand alone activatio
21. less than 60 characters All parameters correspond to the parameter in the Create Activation Key GUI The t parameter specifies whether this key is a normal n the default or ReActivate key r To build import key you must have the MySQL connector kit installed instructions for this are in step 4 of the Activation Pro Setup chapter To compile and link import key where sql is the directory where the mysql connector kit is installed cc c import key c Isgl include cc o import key import key o sqgl lib libmysglclient a Im RLM Activation Pro Manual Page 35 of 68 RLM Activation Pro Manual Page 36 of 68 Appendix A Activation API The RLM Activation API consists of five calls rlm activate the new preferred activation request call rim act new handle rlm act destroy handle rlm act set handle rlm act revoke In addition the following 2 calls are now deprecated rlm act request the old activation request call rlm act refresh These calls are all documented in the RLM Reference Manual RLM Activation Pro Manual Page 37 of 68 Appendix B Example Program The following is the source code to the activation demo program actdemo This example program actdemo c is contained on the RLM kit in the examples directory TK ck ck ck ck ck ck ck ck ck ck ck ck ck ck ck ck ck ck ck ck ck RK ck ck ck ck ck ckck ck ck ck ckck RR KK OK OR KK OK OR KK OK KK KK OK KOK KO COPYRIGHT
22. made by your customer via either calls you make to the activation request API or the Reprise supplied activation GUI built into the rlm webserver If you use the activation request API rlm_act_request you will get another opportunity to add additional attributes to the generated license These attributes will override any specified in either the activation key or the product definition RLM Activation Pro Manual Page 7 of 68 Note that the system date time on the requesting computer must be within 7 days of the system clock on the activation server If the clocks differ by more than 7 days an RLM ACT CLIENT TIME BAD error status will be returned and no license will be generated Activation Pro Components RLM Activation Pro consists of 5 components activation admin tool rlc activation server license generator actpro mklic isvname gen or isvname mklic activation data activation request API rlm activate optional activation GUI built into the rlm webserver The activation admin tool RLM License Center rlc allows you to set up the parameters for activation product definitions activation keys list of blacklisted hosts and other setup data as well as view records of license fulfillments The activation server license generator actpro mklic isvname gen or isvname mklic runs on the website in the cgi bin directory and processes activation requests recording the results in the activation database
23. setup program attempts to do this but on some servers the file modes are not set correctly all php files mode 0400 rlmact mysql mode 400 all other files including all files in the images directory mode 0444 Make sure that your cgi bin isvname_mklic program or isvname gen file is read execute to owner ie mode 500 Consider setting up a htaccess file to protect access to the actpro directory Many ISPs have a tool to password protect the directory Reset permissions of the cgi bin and htdocs directories to their original settings Step 4 OPTIONAL Configuring your license generator if you use an ISV defined hostid If your software uses an RLM ISV defined hostid you will need to build a custom license generator for Activation Pro In order to do this you need the MySQL Connector C development environment To install the Connector C development environment RLM Activation Pro Manual Page 15 of 68 1 Browse to http dev mysql com downloads connector c 2 Select the appropriate platform from the drop down list 3 Select the most appropriate distribution for your operating system and download that version Follow the directions for installation Note that you will have to register to download the MySQL software Select a mirror site and download the binaries Save the file 4 Install the connector kit in a convenient location For example on windows you might download the
24. so that we can connect to the license generator RLM Activation Pro Manual Page 43 of 68 5 on the reprise demo site 5 rim act set handle act handle RLM ACT HANDLE ISV void rlmactdemo if stat 0 stat 1 char name 100 int try FILE f x Activation was successful Write the license out Note in this example we try the license file name aN lic and we only try 100 different names You should change this to whatever naming convention you want to use y for try 0 try 100 tryt Sprintf name a d lic try f fopen name r if f FILE NULL struct tm t ifdef WIN32 time_t ltime time amp ltime t localtime amp ltime else struct timezone tz struct timeval tv time t x gettimeofday amp tv amp tz X tv tv sec t localtime time t amp x endif f fopen name w if fprintf f This license created by RLM Internet Activation Mn if t fprintf f Created on 02d 02d 04d at 02d 02d n t gt tm_mont l t tm mday t tm year 1900 t tm hour t tm min fprintf f n s n license fclose f printf Activation successful license file s written Wn name break else printf RLM Activation Pro Manual Page 44 of 68 Error writing license file s n name stat 1 break else printf Nn switch stat char err RLM ERRSTRING MAX 1 case RLM
25. you make in your application to be sure that you have the correct URL for your activation server Be sure that your activation license generator and data files are protected on your webserver by limiting user access to rle especially Admin access Besure that your license generator in the cgi bin directory including any isv generator settings file isv gen is read write execute to the web user only RLM Activation Pro Manual Page 34 of 68 Importing Activation Keys to ActPro On occasion you might want to create activation keys outside of Activation Pro and then import those keys automatically into ActPro You might do this for example if you wanted your order processing system to create an activation key for your customer s purchase then populate ActPro with this activation key The activation pro kit contains an example program to accomplish this This program is called import_key c and it can be used as an example to write your own code or it can be used as is as a command line utility Usage of import_key is as follows import key activation key product id c count t n r e key exp date 1 lic exp date w whitelist o other params n notes The product id and activation key are both required To determine the product id view the product definitions in the Activation Pro GUI and hover over the Product name in the list The product id will be displayed The activation key can be any printable string of
26. 5 Copy the isvname mklic binary to your webserver cgi bin directory replacing the generic generator which was installed earlier when the kit was installed or if you have not installed the files yet copy isvname mklic to the actpro setup directory before ftping the actpro setup directory to your webserver Note Additionally the rlc admin account has an Administer Database menu item which contains an option to upload the license generator from your local system to the webserver cgi bin directory Using rlc with https rlc can be configured to use the https protocol To do this copy the file Ataccess https in the actpro directory on your webserver to ifaccess in the same directory You may get a certificate warning message the first time you connect to the site which you can ignore If you want to fix the certificate warning you will need to purchase an SSL certificate for your website Note that the license generator itself ISV mklic will not work with https The traffic from the rim act request call to the license generator is already encrypted as of RLM v9 0 so activation keys are not sent in the clear RLM Activation Pro Manual Page 16 of 68 Database Setup using rlc In order to set up activation you do 3 things l install the Activation Pro software on your webserver described in the Activation Pro Setup chapter on page 12 Not necessary for Reprise Hosted Activation customers 2 setup the Activati
27. Activation customers do not need to worry about software upgrades we do these for you You should follow these steps 1 Back up your MySQL database This can be done with the phpMyAdmin program available as part of XAMPP and on most web hosting companies admin pages Select your database click on the export tab and press GO in the bottom right hand corner Save the file While this step isn t strictly required it is strongly recommended by Reprise Software 2 Install the new Activation Pro software Do this the same way you installed Activation Pro initially extract the kit Copy your isv generator settings file to the main directory e g actpro x86 12 and the actpro setup directory on the kit see the next chapter for details Remove the actpro setup directory on your webserver If your web server is local then edit the HTDOCS variable and run make If your web server runs at an ISP ftp the actpro setup directory and all it s contents to your ISP as you did in the initial installation Browse to actpro setup setup php on the webserver just like when you first set up Activation Pro The setup program will detect that you have an installation present and will prompt you to upgrade If you select yes it will then back up the program directory actpro install the new software into a new actpro directory and upgrade the database from the old version to the new version RLM Activation Pro Ma
28. EH CANTCONNECT URL printf You were unable to connect to http www reprisesoftware com Nn printf Please make sure that this system is able to n printf access the internet and try again Mn break case RLM ACT NO KEY MATCH printf The activation key you supplied s was Wn akey printf not found Please check the key and ensure n printf that you have entered it correctly Nin break case RLM ACT KEY USED printf The activation key you supplied s n akey printf has already been used to activate a license An printf Please check the key and ensure that you have entered it correctly Nn break case RLM EH BAD HTTP printf Bad HTTP transaction Wn s Mn rim errstring 0 rh err break default printf Error d requesting activation Mn sMn stat RLM ACT ERR stat rim act errstring stat rim errstring 0 rh err break printf Nn s return stat int dodeactivation RLM HANDLE rh const char name int stat RLM EH READ NOLICENSE If they say NO no license char x 100 void printf nWould you like to deactivate the s license now name fgets x RLM MAX LINE stdin LE FSS hy ee SS UY d Request the deactivation RLM Activation Pro Manual Page 45 of 68 if stat 0 revoke Deactivation was successful X printf License successfully revoked n else char err RLM ERRSTRING MAX 1 prin
29. If you delete the last contact for a company you will be prompted to delete the company record itself Database Viewing Updating Commands These commands are e View Product Definitions e View Activation Keys View Fulfillments View Customers View BlackList Reports About rlc and Manual These commands all allow viewing of the activation database The first 2 commands also will allow you to edit product definitions and activation keys by pressing the Edit icon an image of a pencil at the end of the row in the display Product definitions and Activation Keys which are disabled are not deleted but will appear in gray in the list and can be re enabled later While viewing activation keys the product name is underlined Hovering the cursor above the product name will display a popup listing the product s license name version and type You can also view the fulfillments done for a particular activation key by clicking on the Show icon a small image of a computer screen at the end of each row in the View Activation Keys display The View Fulfillments option will allow you to look at activation fulfillments from your website In addition beginning in v9 2 you can delete an individual fulfillment in order to re enable the count consumed on that activation key by that particular fulfillment This is particularly helpful when you are testing the activation software and you want to be able to regenerate a lic
30. MANY HOSTID CHANGES 1014 Refresh type activation has had it s hostid changed too many times RLM ACT BLACLISTED 1015 Activation attempted from a host which is blacklisted for this server Update the blacklist if it is not accurate RLM ACT NOT WHITELISTED 1016 Activation attempted from a host not on the whitelist for this activation key Update the whittelist if it is not accurate RLM ACT KEY EXPIRED 1017 The activation key itself has expired This would be a normal error for your customer who attempts to use an expired activation key RLM ACT BAD GENERATOR 1020 License keys in generator ISV gen bad or expired or the generator is missing Check your license generator to make sure it was built with a correct license to run h RLM ACT NO KEY MATCH Activation Key can t be This would be a normal error for a customer RLM Activation Pro Manual Page 58 of 68 Status return Problem Solution 1021 found in database who uses an incorrect activation key RLM ACI DB READERR Error reading data from The activation key table has the wrong 1026 number of columns this can happen if you MySQL use a v9 1 database with the v9 2 software The product definition table has the wrong number of columns RLM ACT GEN PARAM ERR 1027 Error in generator call to rim sign license The license string passed into rim sign license is incorrect mo
31. Pro Manual Page 55 of 68 Appendix G Document Revision History V9 3 15 February 2012 v9 3 release BL2 v9 3 21 November 2011 First v9 3 beta release BL1 V9 2 28 September 2011 v9 2 release BL2 v9 2 September 2011 First v9 2 release BL1 first release with PDF manual V9 1 2 May 2011 v9 1 release BL3 HTML wiki manual v9 Mar 2011 Second v9 1 beta release BL2 second beta release HTML wiki manual v9 1 Feb 2011 First v9 1 beta release first release with Activation PRO BL1 HTML wiki manual RLM Activation Pro Manual Page 56 of 68 Appendix H Diagnosing Activation Problems When you call rlm_act_request errors can come from either the server side or locally This section lists most of these errors and what they mean Errors detected and returned by the activation server ISV_mklic Status return RLM EH BADPARAM 123 Problem Error creating license Solution If RLM EH BADPARAM is returned without a corresponding secondary error this is an error on the server side generating the license Most likely this means that some part of the license contains illegal characters generally in the extra parameters supplied in the product definition activation key or in the rlm_act_request call itself RLM EH ACT BADLICKEY 135 Bad license key in activation binary settings Your SV mklic binary or generator settings file has incorrect
32. RLM Activation Pro Manual RLM v9 4 July 2012 Reprise OFTWARE RLM Activation Pro Manual Page 1 of 68 RLM Activation Pro Manual v9 4 July 2012 RLM Documentation Copyright C 2006 2012 Reprise Software Inc RLM Reprise License Manager Copyright C 2006 2012 Reprise Software Inc RLM Activation Pro Reprise License Manager Copyright 2006 2012 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 eay cryptsoft com All rights reserved RLM contains software the GoAhead WebServer developed by GoAhead Software Inc http www goahead com Some RLM documentation is produced with TiddliWiki Copyright c Osmosoft Limited 14 April 2005 The r mid options contain copyrighted materials as follows e rimidl devices are manufactured by Aladdin Knowledge Systems Inc SafeNet Inc RLM Activation Pro Manual Page 2 of 68 Contents A CHV ATION OV ONVICW p Ss 7 Upgrading from an earlier version of Activation Pro 11 Eurum 12 DIEIFnPTITANIUI P
33. RLM license file keys Re build and install the new binary or settings file REM EH BAD HTTP An unknown HTTP error This is usually an installation problem 136 was returned to the RLM Some possibilities are activation client you have specified an ISV name software which is incorrect e the ISV web server is not configured correctly e the SV mklic binary is not for the correct architecture RLM EH ACTPRO UNLICENSED 160 Activation Pro license missing or invalid Check the actpro lic file in the cgi bin directory Make sure it is for rlm actpro ISVNAME where ISVNAME is your ISV name and that it hasn t expired RLM ACT NO KEY 1002 No activation key supplied to the activation server This is an error in the configuration of your software RLM ACT NO PROD 1003 Activation key specifies a non existent product Make sure your activation key refers to an existing product This is a setup problem RLM ACT CANT WRITE KEYS 1004 Cannot write the license key fulfillment data This is an internal server error Check to make sure the MySQL server is running correctly RLM ACT KEY USED 1005 Activation key already used The supplied activation key has already been used and no more activations are available RLM ACT BAD HOSTID 1006 No hostid supplied to the activation server This is an error in the configuration of your software RLM ACT BAD HO
34. STID TYPE No acceptable hostid Activation will only accept hostids of types RLM Activation Pro Manual Page 57 of 68 Status return 1007 Problem type transmitted to activation server Solution 32 bit ethernet disksn rlmidN or ISV defined In addition hostids with value 0 are rejected as is 32 bit hostid 7f0100 the default linux hostid This error will also occur if there is an illegal character in a valid hostid type RLM ACT CANTREAD DB 1010 Cannot initialize MySQL or connect to the database Make sure that the isvname mysq file in the cgi bin directory contains the correct server name port username password This error can also result from a missing or empty generator settings file in the case of RLM Hosted Activation To debug this problem v9 3 or later set the environment variable RLM ACT SQL DEBUG then run the activation generator as follows ISV_mklic lt lt EOF akey 1 amp hostid 2 EOF The generator will then print to stdout the SQL error status RLM ACT CANT WRITE FULFILL 1011 Cannot write the license key fulfillment data This is an internal server error Check to make sure the MySQL server is running correctly RLM ACT CLIENT TIME BAD 1012 Time on client machine is more than 7 days off from server machine Correct the time difference between client and server machines must be 7 days RLM ACT TOO
35. Windows x86 32 bit MSI Installer Select the mirror site then download Once downloaded start the installer by double clicking on it s icon Click past the security warning accept the license agreement then click next and select a custom installation unless you want to put the kit in the standard location Click Next then Install On Linux you might pick the Linux Generic platform and the Linux ver 3 glibc2 x86 32 bit Compressed TAR Archive Select the mirror site then download save the file Once downloaded gunzip the installer and change directory to where you want to install the MySQL software Extract the installer with tar Click past the security warning accept the license agreement then click next and select a custom installation Unless you want to use the default location Click OK Click Next then Install Once the Connector C development kit is installed do the following 1 edit the makefile in the Activation Pro kit and change the definition of MYSQLDEV to be the directory where you installed the Connector C kit 2 edit the makefile and change the definition of ISV DEF HOSTID OBJS to point to your object files that implement your ISV defined hostid 3 Copy the RLM library rlm a or rlmclient lib on windows from a production RLM kit of the correct platform 4 create the custom generator by typing make isvname mklic where isvname is your ISV name
36. _ Activation Pro pdf The enduser manual is in wiki format This manual is also available at the Reprise Website http www reprisesoftware com kits RLM_Enduser html RLM Activation Pro Manual Page 4 of 68 What s New in RLM Activation PRO v9 4 This section lists the new features in RLM Activation Pro v9 4 along with pointers to the relevant sections in the manual What s new e The Administer Database form available to admin users only now allows you to back up the database Selecting this option will create a file of SQL commands to restore your database e The Activation Pro kit no longer requires anything to be compiled as part of the installation process The only reason you would have to compile anything now is if you need to build a license generator to support an ISV defined hostid e The activation database now contains customer contact info which can be associated with activation keys See Customer List on page 27 for more information When creating activation keys the keys created are now displayed on the screen e RLC login passwords can now contain uppercase characters Prior to Activation Pro v9 4 passwords could consist only of numbers and lowercase letters Uppercase letters are now allowed e Product Definitions can now be deleted If a product definition has no associated activation keys a delete icon will appear in the list of product definitions clicking this will delete the product definition e A
37. a product license name i e what you check out in your application a product version anoptional upgrade from version alicense type anissued flag optional additional attributes for the license a product expiration specification RLM Activation Pro Manual Page 20 of 68 The product definition name is the name used to refer to this product definition It is not the name of the product license generated by RLM activation This might be something like Evaluation Office License in which case the actual product name might be Office The product name is the name of the RLM license to be generated This is the name that appears on the LICENSE line in your RLM license file The product version is the version of the product on the generated LICENSE line The upgrade from version is the minimum version of the old product which is eligible for upgrades in an RLM UPGRADE license The license type controls the type of generated license Choices are e node locked uncounted single floating upgrade floating licenses only In the case of floating licenses the requested count is the number of floating licenses generated The requested count must be less than or equal to the remaining count available in the activation key As a special case a request for 0 licenses will fulfill all remaining licenses from the activation key For the other license types the requested count is ignored The Create issued today chec
38. age 5 of 68 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 68 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 activation key is supplied the license is retrieved transparently From this point on the product runs with its license in place Floating licenses would operate in a similar manner except that the number of floating licenses to be activated is required RLM Activation Pro utilizes a MySQL database for storing all activation data for quick access to large amounts of activation data The rlc back office GUI is written in PHP and runs against the same databases as the activation license generator The RLM kit contains a demo of the activation capability For more information on this demo and how to run it see This
39. ame string 20 size Size of text box in UI int 3 op Table for report data string 20 value Value for fixed selection criteria string 64 stats Activation statistics This table is read only by rlc Read write by the license generator Contents column meaning data type date Date in the format yyyy mm dd hh This record char 13 collects statistics for 60 minutes starting at the hour indicated Primary key total Total transactions with the activation server int 11 good Completed license fulfillments int 11 badkey Unknown activation key supplied int 11 checks Reprise pings the hosted activation servers with an int 11 invalid activation key to check that the website is up the license generator is working and the database is working This 1s a bad key where the key supplied is rsi check act server numfulfill Number of num fulfill commands executed Used int 11 by rlm_act_revoke rmfulfill Number of remove fulfill commands executed int 11 Used by rlm act revoke badtime Number of otherwise good requests from clients with int 11 clocks which are off by more than 7 days prod Number of list product commands executed Used int 11 by rehostable hostid activation RLM Activation Pro Manual Page 53 of 68 Appendix E Upgrading from RLM Internet Activation If you are a current RLM Internet Activation customer you will have a production activation database This section descri
40. ase letters and uppercase letters only Administer Users administrator users only allows the administrator to create and delete users as well as modify the access permission of any user Administer Database administrator users only allows the administrator to upload the license generator settings and perform backup operations on the database In addition you can configure the automatic blacklisting of domains and check database consistency with commands in this screen Logout logs you out You will want to have non administrator users for the day to day operations of managing your activation server To create these user s log in to the activation server as the admin user then create a second user who can make changes to the activation database Perform the following steps 1 Point your browser to your installed version of Activation Pro for example http localhost actpro index php 2 On the left hand side of the screen near the bottom type admin in the Username box and admin in the password box Press login This assumes you did not change the default admin user s password 3 Select Administer Users from the lower left menu 4 Press Create New User in the view area below the list of users 5 Select a username password and Edit access in the Create New User page then press the Create User button Go back to the admin page by clicking on the Admin Page link You shou
41. bes how to upgrade that database to RLM Activation Pro The upgrade procedure should be performed after you install RLM Activation Pro but before you add any data to the database To upgrade your production database change directory to the directory containing your RLM Internet Activation data files and perform the following steps cd activation directory run rlmact2sgl from the activation pro directory activation pro dir rlmact2sql isvname where isvname is your ISV name This will create a database update file named isvname_db sql Login to activation pro as the admin user e nthe login section of activation pro select Administer Database e nthe section of the next screen under Upload Activation database data click to browse to the isvname db sql file you just created e Select Upload File to the right hand side of the filename That is it rlmact2sql will read your existing data from the import file and create the data in your new Activation Pro MySQL database RLM Activation Pro Manual Page 54 of 68 Appendix F Frequently Asked Questions Reprise Software maintains a list of frequently asked questions on our website For the current list of Frequently Asked Questions please see our website For ISVs see the FAQ at our support site at http www reprisesoftware net support forum For Your End Users see the End User FAQ at http www reprisesoftware com support faq php RLM Activation
42. ctivation Keys can now be deleted If an activation key has no associated fulfillments a delete icon will appear in the list of activation keys clicking this will delete the activation key e The View Product Definitions View Activation Keys and View Fulfillments buttons now allow you to filter the product definitions which appear See the documentation on the particular command for more information e The activation PRO license generator now collects usage statistics These can be displayed in the new Statistics report under Reports e The activation PRO license generator now monitors bad key requests by IP address and will automatically blacklist an IP address if too many incorrect activation keys have been presented See Appendix K Automatically blacklisting IP addresses on page 66 for more information The login subdirectory has been removed from the kit The login functions are now in the main actpro directory e The underlying actpro code has been updated to use the mysqli API rather than the older mysql API e The ActPro installation now auto detects the location of the cgi bin directory rather than having it hard coded to cgi bin e The administer database menu now has a Check Database button to check the database consistency Several internal tables will be checked for missing product definitions or activation keys when this command is executed RLM Activation Pro Manual P
43. d keys 30 If this of bad keys are attempted within of seconds the IP address is blacklisted in this seconds 300 SetParameters In this example 30 bad activation keys within 5 minutes will cause the IP address to be blacklisted To set the parameters enter the 2 parameters into the text boxes and press Set Parameters Once blacklisted the IP address will appear in the normal blacklist The blacklisted IP address will have to match the IP address exactly rather than the substring domainname match of normal blacklisted hosts RLM Activation Pro Manual Page 66 of 68 Appendix L How Activation Pro chooses a hostid RLM Activation Pro will chose a hostid for the generated license based on the input from the RLM licensed application If your application does not specify a hostid to the r m act request or rlm activate call then the RLM client library supplies the standard set of hostids for the machine on which the software isrunning Alternately you can specify a hostid list in the rlm act request call or via the rlm act set handle call if you use rim activate rim will only activate licenses with rehostable non zero RLM HOSTID 32BIT RLM HOSTID ETHER RLMIDn RLM DISKSN or ISV defined hostids Any other hostid will return an RLM ACT BAD HOSTID TYPE status from r m act request Note ISV defined hostids were added to the list of legal hostids in RLM v4 0 The priority is e Ifarehostable hostid is p
44. d status is 0 good or ul lt 0 error we do not continue If the returned status is x positive the activation succeeded and we need to re init and attempt the checkout again E stat getstat rh lic product if stat lt 0 break if lic rlm checkin lic RLM Activation Pro Manual Page 38 of 68 EA xf Static int rim close rh loopt if stat 0 We got the license void printf Enter lt CR gt to continue x fgetc stdin if lic rlm_checkin lic rim close rh else checkout and or activation failed void printf Unable to check out activate actdemo license n return 0 getstat RLM HANDLE rh RLM LICENSE lic const char name int stat xy char errstring RLM ERRSTRING MAX char license RLM MAX LINE 1 char akey RLM MAX LINE 1 y stat rlm license stat lic if stat 0 void printf Checkout of s license OK n name else void printf Error checking out s license n name void printf ss n rlm errstring lic rh errstring void printf nWould you like to activate this license now gets akey if akey y akey Y void printf Enter Activation key for s name gets akey stat rlm act request rh http www reprisesoftware com rlmactdemo akey license if stat 0 stat 1 char name 100 int try FILE
45. e company id Company ID primary key integer company Company name string addrl Address line 1 string addr2 Address line 2 string addr3 Address line 3 string city City string state State string RLM Activation Pro Manual Page 47 of 68 zip Zip Postal code string country Country string ul Unused string u2 Unused string u2 Unused string contact customer contact person information This table is used only by the admin tool Unused by the license generator Contents column meaning data type contact_id Contact ID primary key integer contact Contact person name string Title Job Title string phone Phone string fax Fax string email Email address string notes General notes string company id ID of associated company integer record blacklist blacklist definitions one row per blacklisted host This table is written only by the admin tool Read only by the license generator Contents column meaning data type id row id integer domain the hostname domain of the blacklisted host If this string 255 No string matches any part of the requesting host that host spaces is not allowed to use the activation server RLM Activation Pro Manual Page 48 of 68 keyd activation key definitions one row per activation key This table is written only by the admin tool Read only by the license generator Contents
46. e Example code An example for rehostable licenses is on the RLM kit in the examples directory called rehost example c It is repeated here The important calls to do the rehosting are highlighted in J FCKCKCKCKCK A RRA kkk kkk kkk kkk k k kk k k k k kkk k k k k k k k k k A ARIA IRI k k k k k k k k k k k I k k k k COPYRIGHT c 2005 2012 by Reprise Software Inc This software has been provided pursuant to a License Agreement containing restrictions on its use This software contains valuable trade secrets and proprietary information of Reprise Software Inc and is protected by law It may not be copied or distributed in any form or medium disclosed to third parties reverse engineered or used in any manner not provided for in said License Agreement except with the prior written authorization from Reprise Software Inc KK CKCKCKCK ook KK CKCK oko k CK CKCKCKCK koc k CK KK ok CK KK ok CK KK KK ok KK CKCkCko ko ko k Kk Ckkokoko kk koe ke eee ke eek Description Example client for RLM license rehosting revoking M Christiano 11 18 11 modified from the regular activation example Id rehost example c v 1 3 2012 01 04 00 44 04 matt Exp include license h include lt stdio h gt include lt stdlib h gt RLM Activation Pro Manual Page 41 of 68 include lt string h gt static int checkstat RLM HANDLE RLM LICENSE const char static int doactivation RLM HANDLE const char static int dodeactivation
47. eates It includes the optional attribute refresh 1d which is the activation key for refreshing the license This 1s also used by the activation utility It includes a the options attributes start date and replace which are used internally by the rlm library to obsolete previous instances of the same license NOTE At the time of this release v7 0 the refresh utility supports only nodelocked uncounted licenses Refresh Utility Reprise supplies both a stand alone utility isv refresh that can be used as is at the end user site to refresh licenses and an API Appendix A Activation API on page 37 around which the ISV may build a custom refresh utility rlmutil rlmrefresh takes an argument specifying the directory in which it should process rehostable licenses and an optional argument specifying the name of an ISV whose licenses are to be refreshed Without the ISV argument isv_refresh processes rehostable licenses from all ISVs in the specified directory It prints details about any errors it encounters while refreshing the licenses unless the optional q argument is specified On Windows a batch script can be set up to supply arguments and also to redirect the output to a file It can be run manually but it is intended to be run automatically as a cron job on Unix or a Scheduled Task on Windows The norm is to run it once a day In order to avoid all end users refreshing their licenses at the same time every day and over
48. ense for a particular hostid since a re activation from the same hostid would return the old license By deleting the old fulfillment the activation software will generate a new license with a new expiration date for that activation key on the hostid The View Customers option allows you to view all customer information in the Activation Pro database This form allows you to edit or delete the customer information as well Note that you cannot delete contacts if they are associated with activation keys View Blacklist allows you to view and edit the list of blacklisted hosts Note that if an entry in the blacklist matches any part of a hostname that host will be blacklisted Thus foo com in the blacklist will also blacklist the host eng foo com Reports are described in a separate chapter See Reporting on page 32 About rlc displays information about the rlc program itself Finally Manual will display this manual in your browser RLM Activation Pro Manual Page 28 of 68 Refresh License URL setup If you plan to use REFRESH type activations deprecated in RLM v9 3 you will need to set up the URL on which your activation server will run This is required for REFRESH type licenses only Select Administer Database from the menu enter the URL in the text box provided and select Set REFRESH URL at the right hand side of the text box Note you must be logged in as the admin user for the Administer Database menu item to appear
49. figured 1019 status 500 correctly Look at the web server error log INTERNAL SERVER ERR files to find the source of the error Without OR this information it is impossible to diagnose the error RLM ACT NO AUTH SUPPLIED 1022 Proxy requires authentication Supply proxy credentials via the HTTP PROXY CREDENTIALS environment variable HTTP PROXY AUTH FAILED 1023 Proxy credentials didn t work Proxy requires authentication and the credentials supplied failed RLM ACT NO BASIC AUTH 1024 Proxy does not support BASIC authentication RLM activation uses only basic authentication with proxy servers RLM Activation Pro Manual Page 61 of 68 Appendix I Refresh type activations deprecated Rehosting via Activation Refresh deprecated Note the REFRESH activation type has been deprecated in RLM v9 3 Please use the new rehostable hostid type if you wish to allow users to transfer licenses from one system to another Activation can be set up to support rehosting of licenses by the end user without ISV involvement This involves the use of refresh licenses which are normal RLM licenses except they are typically issued for a very short duration on the order of days Refresh licenses are reactivated frequently either by a generic utility supplied with RLM or by a utility supplied by the ISV using the RLM refresh API Each time a refresh license is reactivated it gets a new
50. filled the fulfillment count the hostid change rehost count for Refresh type fulfillments only deprecated in RLM v9 3 the last date valid for this activation key the list of allowed domains for this key optional additional attributes for the license optional notes for the activation key unused by RLM RLM Activation Pro Manual Page 22 of 68 In addition when you create activation keys you can also specify the number of independent activation keys to create e the actual activation key string When you press the Create Activation Key button you will see the screen below RLM License Center RLM Activation Pro Copyright c 2006 2012 Reprise Software Inc All Rights Reserved Create Activation Keys Click GENERATE Activation Key s below to create the activation key s Activation Type Normal X Product Name test 1 X of fulfillments for each Activation key 0 for no limit 1 for Refresh 1 j of rehosts allowed Refresh keys only 0 9999 0 of Activation keys to create 1 9999 1 Optional Activation key expiration date Optional License expiration date Overrides Product Definition 0 permanent number of days string fixed date Optional Allowed domains whitelist 64 bytes max Optional Other license parameters Optional Notes Optional Activation Key to use ric will generate if not specified Optional Contact Person None Y
51. he contents of this screen are report type dependent The selection screen for the Activation Keys report is shown below The Product Name choicelist allows you to select an individual product or all Copyright c 2006 2011 Reprise Software Inc All Rights Reserved products RLM License Center RLM Activation Pro The other text boxes allow you Activation Report Generator to filter the various fields in the activation key table In each text box the text you type will be used as a regular expression to select the appropriate rows from the Prodr Name test Ss activation key table So for example if you have an activation key which is 1234 Other License Parameters 5678 abcd efgh then typing 1234 in the Activation Key field will select this key as well as any others with 1234 in the activation key string for the report Report Activation Keys Selection Criteria Activation Key Notes Whitelist CANCEL RLM Activation Pro Manual Page 32 of 68 For the statistics report you can select the date to report Enter the date as yyyy mm dd If you enter only yyyy mm a report for that month will be produced Once you have made your selection click Generate Report and the report will be output If you selected report output to the screen you will see a form very similar to the View Product Definitions or View Activation Keys
52. he activation So for example if you put the string com into this field activation will be possible from any domain with com in the name ie most domains All names are case insensitive and the whole list must be less than RLM MAX HOSTNAME 64 bytes If an activation key specifies allowed domains the general activation blacklist is not used and the domain requesting the activation must be part of the allowed domains specification The Activation Key Expiration date for the activation key is the last date when the activation server will generate a license for this activation key The activation server will continue to send previously generated licenses if so requested Note that this is completely different from the license expiration date in the product definition the last date valid is the last date when the activation server will create a new license for this activation key The License Expiration Date if specified will override the expiration date specified in the product definition If not specified here the license expiration from the product definition is used The date is specified in the same way as in the product definition i e a positive integer indicates a license that expires that number of days from the date of activation and a fixed date specifies a fixed expiration date The Other license parameters are additional RLM license attributes which will be placed into the generated LICENSE Any options specified i
53. hem The RLM kit has an example html file that can be customized for this use It is called activation_example html and it is in the examples directory of the RLM kit Modify this file for your use and put it on an internal site for your support people to use RLM Activation Pro Manual Page 9 of 68 Getting Started First you should read the Activation Overview section of this manual on page 7 Next you should read the three setup chapters e Activation Pro Setup on page 12 Note if you are using Reprise Hosted Activation you can skip this chapter we have already set up Activation Pro for you Database Setup on page 17 and Client Setup on page 30 When you have performed these steps you are ready to issue licenses for your product with RLM Activation Pro To use the RLM Activation Pro administration tool rlc point your browser RLM Activation Pro supports Firefox v3 6 or later to the URL where your system administrator set up the RLM Activation Pro software The webserver will prompt you for your username and password Once you provide these you will see the initial rle screen Login to rlc using the username and password you received from your system administrator the login area is in the bottom left hand side of the screen RLM Activation Pro Manual Page 10 of 68 Upgrading from an earlier version of Activation Pro If you are currently running Activation Pro you can easily upgrade to the new version Hosted
54. ivation key new license generated Refresh 5 mu new license generated if until hostid change count deprecated in RLM v9 3 use request is on a new day exceeded then computed at activation REHOST bl otherwise prior license RLM ACT TOOMANY time ee returned HOSTID CHANGES licenses instead error returned In the table above whenever the action listed is prior license returned the remaining activation count is not decremented Whenever activation generates a new license the remaining count is decremented by the license count generated Activation blacklist RLM Activation allows you to specify a list of unauthorized domains domains which cannot activate licenses If you select the View BlackList button on the bottom left side of the main form you will see a list of blacklisted domains The last item in the list is blank and allows you to add a new domain In addition each domain in the list has a Delete button on the right to remove it from the list The blacklist is a list of domain names which are not allowed to activate using this activation key If a request comes in from any domain on this list it is rejected with RLM ACT BLACKLISTED Note that if any string you enter here is a substring of the domain name then that domain will be rejected All names are case insensitive and each item in the list must be less than RLM MAX HOSTNAME 64 bytes If an activation key specifies allowed domains
55. kbox controls whether the generated license contains an issued today date attribute The other license parameters are additional RLM license attributes which will be placed into the generated LICENSE These must be valid RLM license keyword value pairs e g options professional The License expiration date controls the expiration date for the generated LICENSE line This is one of e 0 or blank for a permanent license aninteger the number of days from activation to expiration ie 30 means the license expires 30 days after it is activated e an actual expiration date in the form 1 jan 2012 the actual expiration date independent of the date of activation in the standard RLM expiration date format Once you have created a product definition the list will be displayed this is the same as if you pressed the View Product Definitions button on the left hand menu RLM Activation Pro Manual Page 21 of 68 Product Definitions Product Name License Name Version Upgrade Version Exp Date Extra License Data Select Show ProductName License Name Version Upgrade Version Expiration License Type Issued Additional License Data Enabled test test 1 0 permanent Nodelocked Uncounted no yes P test product 2 test2 1 0 permanent Nodelocked Uncounted no abc def yes P x actdemo 1 day trial actdemo 1 0 permanent Nodelocked Uncounted yes yes P test product 3 t 1 0 permanent Single no yes PIX
56. l RLM Activation Pro Manual v9 4 July 2012 v9 4BL2 RLM Activation Pro Copyright 2010 2012 Reprise Software Inc All rights reserved RLM Activation Pro Manual Page 3 of 68 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 including the end user manual RLM End User Manual The stand alone end user manual suitable for shipment to your customers Optional RLM Components RLM Activation Pro Manual this manual Reference for the Optional RLM Activation Pro software The RLM Getting Started Guide RLM Activation Pro Getting Started Guide RLM Reference Manual and RLM Activation Pro Manual this manual are available as PDF downloads at the Reprise Website at http www reprisesoftware com kits RLM Getting Started Guide pdf http www reprisesoftware com kits RLM Activation Pro Getting Started Guide pdf http www reprisesoftware com kits RLM Reference Manual pdf http www reprisesoftware com kits RLM
57. ld now see your new user with Edit access 6 Logout at the bottom left Setup Commands The setup commands are Create Product Definition Create Activation Key e View Edit Blacklist Add Customer RLM Activation Pro Manual Page 19 of 68 Product Definitions These commands are used to set up the database for activation and or license generation Everything in rlc is driven from product definitions so you should create at least one product definition first Product definition allows you to specify a name for the product which is then associated with a license product name version and several other license attributes When you press the Create Product Definition button you will see the screen below RLM License Center RLM Activation Pro Copyright c 2006 2012 Reprise Software Inc All Rights Reserved Create Product Definition Click CREATE Product Definition below to create this product definition record Name of this product definition Product Name in generated license Product Version in generated license 1 0 Upgrade from Version 9 Nodelocked Uncounted Single Floating License Type NL Uncounted UPGRADE Single UPGRADE Floating UPGRADE Create issued today yes if checked Optional Other license parameters License expiration date 0 0 permanent number of days string fixed date A product definitions consist of a product definition name e
58. le and if the system should crash the hostid cannot be retrieved As an ISV you will need a policy to deal with this situation e g to give the customer another activation in order to continue Since this situation should be rare a non automated request procedure might be quite sufficient If you use the Normal fulfillment type with Rehostable licenses the expiration date should be fixed If you want an expiration date that is relative to the time of activation you should use the ReActivate fulfillment type and set the count to the of times you want to allow your customer to revoke and re activate the license RLM Activation Pro Manual Page 8 of 68 Why should Normal fulfillments use fixed license expirations Well when your customer revokes a rehostable license the activation server returns the fulfillment count back to the activation key If for example you issue 60 day licenses with Normal fulfillment type your customer could fulfill the license then on day 59 revoke that license and re activate it and get a new 60 day license If the activation key specifies a fixed expiration date that is not an issue Also if you use a ReActivate fulfillment type the original expiration date will be preserved on a new activation What happens if my customer doesn t have an internet connection For cases such as this you can create a webpage so that your customer support people can activate the license for your customer then email it to t
59. le with the following contents Options FollowSymLinks RewriteEngine on RewriteRule http www actual activation domain com 1 R 301 L Note Change actual activation domain to your domain name Also this htaccess method of redirection works ONLY on Linux servers having the Apache Mod Rewrite module enabled RLM Activation Pro Manual Page 65 of 68 Appendix K Automatically blacklisting IP addresses If someone writes a program to guess activation keys they will present a large number of invalid activation keys to the server in a short period of time RLM Activation Pro v9 4 has the capability to automatically blacklist this IP address based on parameters you specify The first time an invalid activation key is presented to the license generator by a particular IP address the license generator logs the time After this if N bad keys are presented within a specified time interval the IP address is automatically blacklisted Once this time interval passes without N bad keys being attempted the whole process resets in other words N bad attempts will be required before the IP address is blacklisted By default the interval is 600 seconds 10 minutes and the number of bad keys which cause the IP address to be blacklisted is 40 However you can change both of these parameters in the Administer Database menu available to admin users near the bottom of the form Automatic blacklisting of IP addresses of ba
60. lied by Reprise Software We recommend that you start this way so that you can become familiar with the server side of activation without having to embed any code into your application In order to proceed make sure that you have set up the server side as described in Activation Pro Setup on page 12 The activation GUI is built into the rlm webserver Run rlm you don t need a license file point your browser at port 5054 or the port number you specified in the ws port specification then select activate license from the menu on the left hand side The GUI will guide you through the steps in activating a license Note prior to RLM v6 0 the default admin port was 9000 not 5054 When the rlm webserver activates a license the resulting license file will be placed in the directory from which rlm was started and the file name will be activateN lic where N is a sequence number Each activation performed will get a new number Note that RLM activation will only operate with non zero RLM HOSTID 32BIT RLM HOSTID ETHER or ISV defined hostid types all other hostid types will return an error RLM Activation Pro Manual Page 30 of 68 Activation API or rlm web interface which to use Note that the rlm web interface is completely generic and you can activate licenses for your products using this interface by setting up activation on your web server and specifying your URL in step 1 However it will always be simpler for your end u
61. loading the ISV s activation server the ISV can request that each end user run the refresh utility at an assigned time every day A custom refresh utility could randomize the refresh time Rehosting Rehosting a license with refresh is a matter of turning off the refreshing of it on the original host and activating it on the new host Disable refresh by disabling the refresh of the directory containing the license if refresh_util is being used Then activate the license on the new host and enable refreshing of the license on the new host Product Definition and Activation Key Creation for Rehostable Licenses Define the refresh URL in rlc Select Setup RLC from the menu on the left and set the URL of the Activation server to contact for refreshes your activation server name eg www reprisesoftware com You only have to do this step one time RLM Activation Pro Manual Page 63 of 68 Define the product in rlc The product must be defined as a nodelocked license as of RLM v7 0 Choose a short duration for the license in the expiration date field You do this each time you set up a rehostable product Create Activation Keys for the product in rlc Under Activation Type choose Refresh Set the number of rehosts allowed to the quantity desired You create one activation key for each customer who has purchased this product RLM Activation Pro Manual Page 64 of 68 Appendix J Redirecting Your Activation Website When you
62. mple test second and test third have no fulfillments so they can be deleted Note that this list was filtered to display only activation keys which contain the string 27 RLM Activation Pro Manual Page 24 of 68 Activation Keys Activation Key Product Name Exp Date Whitelist Extra Lic Data Notes Contact Select 27 Show I Clear Selections Activation Key Enabled Product Count Fulfilled Type rehosts Last Date Valid License Exp Whitelist Extra License Data Notes Contact 2270 7270 4069 6537 Yes test1 1 Normal LX 2271 7270 9166 1851 Yes test 1 1 Normal 2X 2272 7270 1630 2819 Yes test1 1 Normal UP XE 2273 7270 9730 7049 Yes test1 1 Normal Ux 2274 7270 5537 5753 Yes test 1 1 Normal UP XE 2275 7270 2204 8852 Yes test 1 Normal x 2276 7270 1223 7649 Yes lest 1 1 Normal UP XE 2277 7270 7898 4178 Yes test 1 Normal AIX 2278 7270 3492 9870 Yes test1 1 Normal UP XE 2279 7270 9066 7457 Yes test 1 Normal x 2770 7288 3159 5622 Yes Trinity Test 10 Normal UP IX ILE Records 1 to 11 of 11 displayed Items to display 20 Delete Selected Items Fulfillment Type The type of fulfillment controls how the activation server processes requests In all cases for a node locked license the count field represents the total number of independent licenses which can be generated For floating licenses the count field represen
63. n the activation key override corresponding attributes in the product definition thereby allowing you to have default attributes which you modify for a particular customer when you create their activation key These must be valid RLM license keyword value pairs e g options professional The Notes field is unused by the activation software other than in listings and reports The Contact Person choicelist allows you to associate a customer with this activation key Create customers with the Add Customer button in the Setup Commands area at the top The activation key generated by rle is a 16 digit number with embedded dashes for a total of 19 characters of the form aaaa bbbb cccc dddd for example 4567 4997 7125 5436 Alternately rle will allow you to specify the activation key If you specify a key and generate a single key the exact key you specify will be used If you generate multiple keys rle will append 16 characters with 4 dashes to the string you specified This activation key is treated as a string by all RLM activation components Once you have created an activation key the list will be displayed this is the same as if you pressed the View Activation Keys button on the left hand menu This list gives you an overview of the activation keys in your Activation Pro system If any activation key has no associated fulfillments you can delete it by pressing the red X in the far right hand column In this exa
64. n utility described in the Client Setup chapter on page 30 Se pad RLM Activation Pro Manual Page 12 of 68 If you are using Activation Pro at a web hosting company a different set of installation steps will be required In particular step 1 above isn t required The differences will be outlined in the following sections If you are using Reprise Hosted Activation we have done steps 1 3 for you so unless you have an ISV defined hostid step 4 you can skip the remainder of this chapter and go straight to Database Setup on page 17 Step 1 Install a pre configured Apache MySQL PHP AMP stack If you are installing RLM Activation Pro at your ISP you can skip this section If you are evaluating however Reprise Software recommends installing on a local AMP stack before you attempt to run RLM Activation Pro at your ISP To start you need the stack of web services to support RLM Activation Pro A pre configured AMP stack called XAMPP is available for Windows and Linux systems at the Apache Friends website To install it do the following For Windows e Browse to http www apachefriends org en xampp windows html e Below the text Jump off point select the XAMPP download select the Installer link Save the file then run it e For Linux Browse to http www apachefriends org en xampp linux html Follow the 4 steps on the download page e after installing the package will be in opt lampp execute the followi
65. ng commands as root e chmod 777 opt lampp cgi bin e chmod 777 opt lampp htdocs Note these directories would not normally have 777 permissions but we are doing this to make the rest of the setup easier When you are finished reset the permissions on cgi bin and htdocs to their original settings e Now you can log out as root Step 2 Install the RLM Activation Pro kit from the Reprise website RLM Activation Pro operates on a particular RLM binary platform and is supported on windows and linux systems x86 w and x86 1 On all Platforms First download the Activation Pro kit go to the Reprise Website Download area enter your username and password and select the RLM Activation Pro kit Pick the appropriate platform and save this on your system Note When downloading Unix kits using Internet Explorer on Windows XP systems the files are RLM Activation Pro Manual Page 13 of 68 incorrectly named as actpro platform tar tar rather than actpro platform tar gz once downloaded This is a browser issue after transfer please rename the file before installation Or better yet use Firefox Also note if you are installing on your ISP s webserver be sure to chose the RLM Activation Pro kit appropriate for your ISP s operating system Continuing the Installation on Linux Extract the kit files Use gunzip tar to extract the archive g nzip actpro plattform tar gz o tar SME ac
66. ntents column meaning data type id activation product identifier integer active 0 if this definition is inactive 1 if active product definitions integer are not deleted name Product Definition name string version the RLM product version string upgrade_ Upgrade from version number UPGRADE licenses only string version exp If a number number of days to expiration of the license after string product activation If 0 the license does not expire If a standard RLM date format it is a fixed expiration date lictype 0 floating 1 node locked uncounted 2 node locked integer counted unimplemented 3 single 4 UPGRADE floating issued 0 do not include issued in license 1 include integer issued today s date in license product License product name string misc any optional RLM license attributes string setup RLC setup definitions one row per setup item This table is written only by the admin tool Read only by the license generator This table contains data such as the activation URL for refresh Activation Pro version etc Contents column meaning data type what Description of the data item string 30 data The actual data string 64 RLM Activation Pro Manual Page 51 of 68 users authorized rlc users This table is used only by the admin tool Unused by the license generator Contents column meaning data type user username string password use
67. nual Page 11 of 68 Activation Pro Setup In order to set up activation you do 3 things 1 install the Activation Pro software on your webserver If you are a Reprise Hosted Activation customer you can skip this chapter and move straight to step 2 2 setup the Activation Database described in the Database Setup chapter on page 17 3 Add activation request calls to your application described in the Client Setup chapter on page 30 Requirements Setting up RLM Activation Pro involves setting up a webserver with PHP and MySQL support as well as the RLM Activation Pro software Ideally you should be familiar with downloading and installing open source tools and using Web infrastructure RLM Activation Pro requires The Apache Web server version 2 2 or greater PHP version 5 with MySQL extensions MySQL server version 5 1 or greater MySQL Connector C development kit you will only need this for linking your license generator and you only need to do this if you are using ISV defined hostids Mozilla Firefox v3 6 for running r c the administration tool To get you started as quickly and easily as possible with RLM Activation Pro we suggest that you install a pre configured Apache MySQL PHP AMP stack Reprise Software recommends the XAMPP stack from Apache Friends This is the stack which we use to test Activation Pro It is free and it comes pre built for all platforms on which we support RLM Activation Pro although
68. on Database described in this chapter 3 Add activation request calls to your application described in the Client Setup chapter on page 30 All RLM activation activities are controlled by a database of product definitions and activation key definitions In addition you can create a blacklist of domains which are not allowed to activate licenses Before you can begin to use RLM activation you must set up at least one product definition and one activation key definition as described below You should also set up your activation URL for REFRESH licenses if you are planning on using REFRESH type activations deprecated in RLM v9 3 These operations are performed by rle RLM License Center rle is a web based application which allows you to maintain your activation database rlc uses user access permissions to control access to the three main functions viewing and reporting on the activation database View Access editing the activation database Edit Access administering users permissions database Admin Access Running rlc You run rlc by pointing your browser to the URL where you installed the Activation Pro software The server uses a MySQL database to store all the activation data rlc Access Control Access control is performed by logging in as the admin user and creating individual user accounts An account has one of 3 levels of access View Edit Admin An account with View access can view the activation da
69. ontact person record If you are adding a completely new customer add the company first then add the contact person Company Info Contact Person Info Company Contact Person Addr line 1 Title Addr line 2 Phone Addr line 3 Fax City Email State Notes ZIP Postal code Company None M Country Add Company Info Add Contact Person Info Return to Customer List You first add the company then add contact people for that company Note that you are not required to add company information for contacts if you prefer to have only the person s name and other info from the Contact Person Info side of the form Once you have added some Contacts to the system you can assign them to activation keys After creating contacts the list is displayed Customers Name Title Company Phone Email Notes Select Show Clear Selections Name Title Company Phone Eax Email Notes Address Matt Chistiano CEO Reprise Software Inc 555 1212 matt reprisesofware com 1530 Meridian Avenue San Jose CA 95125 USA No Company person Works at home ZX Records 1 to 2 of 2 displayed Items to display 20 You can edit individual contacts with the edit button on the right If the contact is not associated with any activation key pressing the delete button will confirm that you want to delete the contact
70. r s encrypted password string userid User Identifier string userlevel User access 1 view 2 edit 9 admin integer timestamp Last time user logged in integer report_cols database columns which appear in report This table is read only by rlc Unused by the license generator Contents column meaning data type id Primary key int report Report name string 40 displayorder Order to display selections int 2 tablecolumn Column name from table string 40 display Report column header text string 30 var POST variable name string 20 is int If non zero column contains integer data int 1 report_types report type definitions This table is read only by rlc Unused by the license generator Contents column meaning data type report Report name string 40 tablename Table for report data string 40 displayorder Order to display report names int 2 report header Display header for report string 80 RLM Activation Pro Manual Page 52 of 68 report select report selection definitions This table is read only by rlc Unused by the license generator Contents column meaning data type id Primary key int report Report name string 40 fixed Is selection criteria fixed or variable int 1 displayorder Order to display selections int 2 display Text to display in UI string 40 var POST variable n
71. resent it will be used e Ifan ISV defined hostid is present it will be used e Ifanrlmid hostid is present it will be used e Ifa Disk Serial Number hostid is present it will be used Otherwise if an ethernet address is present it will be used Finally if none of the hostids above are present in the list the 32 bit hostid will be used fnone of the hostid types above are present the activation software will return RLM ACT BAD HOSTID TYPE You can override RLM s notion of the hostid and specify an exact hostid to be used by the activation server by calling r m act set handle with the RLM ACT HANDLE HOSTID LIST parameter or passing the hostid list parameter to rlm act request The hostid list parameter can contain a list of hostids for use in nodelocked licenses This is specified with the following syntax list list of hostids For example list user joe host sam ip 192 16 7 23 3f 902d8b0027 If a list is supplied note the following e The activation software uses the hostids in the list as you specified even if they are not secure e fthe license to be activated is a served license floating only the first hostid in the list is used e The number of available activations on the activation key is decremented by 1 regardless of the number of hostids in the license created e The hostid list must be less than RLM ACT MAX HOSTID LIST characters long 205 including the list prefix
72. sers if you integrate the RLM activation API into your product or installation tools since you can preset many of the activation parameters such as URL ISV name etc Other Client side activation options Alternately you can create a custom stand alone activation utility for your customers rather than building it into your application Follow the steps above for using the Activation API Also you can create an html page to activate licenses using your activation server For an example of this see activation example html in the RLM kit examples directory This technique however will require your customer to cut and paste the resulting license file into the appropriate file on their system Using Proxy Servers The RLM Activation client software either the rlm_act_request API call or the RLM admin web interface will make use of a user defined proxy server In order to use a proxy server set the environment variable HTTP_PROXY or http proxy to the hostname and port number of the proxy server For example to utilize the HTTP proxy server running on myproxyhost on port 8765 use the following command on unix setenv HTTP_PROXY myproxyhost 8765 If your proxy server uses authentication you use the HTTP_PROXY_CREDENTIALS environment variable to pass the credentials to the proxy server HTTP PROXY CREDENTIALS the username and password to authenticate you to the proxy server in the format user password For example
73. st likely because something in your extra license parameters is invalid RLM_ACT_UNSUPPORTED_CMD 1028 Unsupported command This is an error that a non Activation PRO server returns when an advanced command is issued to it RLM_ACT_REVOKE_TOOLATE 1029 Revoke attempted after license expiration Licenses cannot be revoked after they expire RLM Activation Pro Manual Page 59 of 68 Errors detected and returned locally by rlm_act_request or by the HTTP server Status return RLM EH NET INIT Problem Can t initialize the networking Solution Most likely the URL specified in the call is 103 code incorrect RLM ER NET WERR Cannot write data to network Most likely the URL specified in the call is 104 incorrect RLM EH NET RERR 105 Can t read returned message from network If the write succeeds and the read fails then it is likely that there is a proxy server in the middle Try setting HTTP PROXY RLM EH BADPARAM with RLM ACT BP TOOMUCH sub error 123 Request is too long to communicate Check the length of the extra license parameters the hostid list and the log data Each of these should be 80 bytes RLM EH CANTCONNECT URL 132 Can t connect to the specified URL Check that the URL is correct and that the activation server is installed in cgi bin Pass the URL without the trailing cgi bin e g http www reprisesoftware com
74. still good for another 3 days enough time to resolve the refresh failure Rehostable licenses also give the ISV a way to revoke a license granted to an end user should that user fail to meet contractual obligations for example The ISV can simply disable refresh of the user s license on the activation server and refresh attempts of that license will fail from that point forward The client side of refreshing is automated so it can be performed daily without an undue burden on the end user Reprise supplies a Refresh API for license refreshing which the ISV can use in a custom developed refresh utility Reprise also supplies a generic refresh utility which can be supplied to the end user by the ISV The generic utility refresh_util is meant to be set up to run daily as a Scheduled Task on Windows or as a cron job on Unix RLM Activation Pro Manual Page 62 of 68 Rehostable Licenses A license is rehostable if the activation key that was used to activate it is a refresh type activation key This is set in the rlc page that creates activation keys The license generator does a couple of special things when it activates refresh licenses It includes the optional attribute refresh url This is the URL that the refresh utility contacts to refresh the license that is the ISV s activation server This is specified by the ISV in rlc in the Setup RLC section The activation server includes the refresh URL in every refresh license it cr
75. ta but cannot create or edit any data An account with Edit access can do anything an account with View access can do as well as edit any data except user accounts An account with Admin access can do anything an account with Edit access can do as well as create and delete users upload the activation license generator settings and perform other administration functions RLM Activation Pro Manual Page 17 of 68 Using rlc There are 3 main activities you will perform with rle initial setup of your activation database viewing and or updating the activation data generating individual licenses When you run rle your browser will display a page that has a title area at the top along with a column of command buttons along the left and a main display area on the bottom right hand side as shown below RLM License Center RLM Activation Pro Reprise SOFTWARE Copyright c 2006 2012 Reprise Software Inc All Rights Reserved RLM License Center RLM License Center RLM Activation Pro v9 4 This web interface is used to administer the RLM Activation Pro database Choose a command ric allows you to perform status and administration functions on the RLM activation database from the list below g To begin please log in Then choose a command from the list on the left hand side of the window San Jose CA 95125 www reprisesoftware com info reprisesoftware com Create Product Definition Create Activation Key
76. tf Mn printf Error d requesting license revoke n s n stat RLM ACT ERR stat rim act errstring stat rim errstring 0 rh err printf Mn return stat RLM Activation Pro Manual Page 46 of 68 Appendix D Activation Database RLM activation uses a MySQL database to store all data There are a total of 11 database tables active users the currently active users company table of customer companies contact table of customer contacts blacklist blacklist definitions keyd The Activation Key definitions prod The product definitions setup Activation setup data keyf The Activation key fulfillment status licf License Fulfillment data report types report type definitions report select selection criteria for reports report cols database columns which appear in reports users Table of authorized users Each table indicates whether the admin tool and or the license generator read and write to it The contents of these tables is as follows active users active rlc users This table is used only by the admin tool Unused by the license generator Contents meaning data type user username logged in string timestamp Time user logged in integer company customer company information This table is used only by the admin tool Unused by the license generator Contents column meaning data typ
77. thout ISV involvement This involves the use of the rehostable hostid type which is new in RLM v9 3 A rehostable hostid is requested at the time that r m_activate is called and the activation server issues the license to this hostid Later if the user wishes to move this license to another system the rlm_revoke call can be used to revoke the rehostable license and allow it to be activated on another system Note that the rehostable hostid is a copy protected file and if the system should crash the hostid cannot be retrieved As an ISV you will need a policy to deal with this situation e g to give the customer another activation in order to continue Since this situation should be rare a non automated request procedure might be quite sufficient Rehostable license support is limited to only nodelocked uncounted licenses In addition only a single version of any product can exist with a rehostable hostid on a system at any given time Attempting to activate a 2 product with a different version number will give an RLM EH REHOST EXISTS 153 error from activation Finally you should always use a fixed expiration date if you are using the Normal fulfillment type for Rehostable licenses If you want an expiration date that is relative to the time of fulfillment then you should use a ReActivate fulfillment type and set the count to the of times you want your customer to be able to revoke and re activate the license Rehostable Licens
78. tivate fulfillment type for Rehostable licenses if you want to deliver a license which expires some number of days after it is first activated The count will control how many times they can revoke and re activate the rehostable license For the Refresh fulfillment type the count field must be 1 rlc will store the count as 1 independent of what you enter In other words only a single activation can be supported in a Refresh license activation This license is then refreshed over time and the hostid can be changed up to the hostid change count Refresh licenses will always have the REPLACE option specified as well as an ISSUED date If multiple Refresh requests are made on the same day all will return RLM Activation Pro Manual Page 25 of 68 the same license A new request on a subsequent day will return a new license You should never use the Refresh fulfillment type for Rehostable licenses Note Refresh type activations are deprecated in RLM v9 3 This processing for each type of activation key is described in the following table Activation type Newrequest fromthe New request from new expiration date of same hostid with hostid or same hostid license same count with different count new license generated if Normal prior license returned sufficient activation count is available computed at activation time same expiration date as Reactivate prior license returned new license generated first activation done with this act
79. tpro plarttorm tar Continuing the Installation on Windows Extract the kit files On Windows the kit is in a ZIP file Unzip the file in the desired location Step 3 Configure RLM Activation Pro Copy your License Generator Settings file from your RLM kit You can create the license generator settings file isvname gen on any supported RLM platform To create it execute the following command in the configured RLM kit area rlmsign generator Copy the resulting file isvname gen to the main actpro directory e g actpro x86 12 and the actpro setup directory If you are copying between Unix and Windows systems be sure that your copy program doesn t insert carriage control characters The easiest way to make sure of this is to check the file size to make sure it is the same after copying Install the RLM Activation Pro files on your webserver If vou are running on a local AMP stack follow these instructions Run the command make or nmake for Windows in this directory The make command will copy all the Activation Pro files to your webserver space as specified by the HTDOCS variable in the makefile The files will reside in HTDOCS actpro setup ready for the next step If you are running at your ISP follow these instructions run the command make setup or nmake setup for Windows FTP the contents of the actpro setup directory to your ISP s webserver space e g www yourdomain
80. ts the total license count of all floating licenses generated The Normal fulfillment type is the most straightforward activation type and represents what most people think of as software activation each request from a new hostid generates a new license and this license s expiration date is computed at the time the license is activated A subsequent request from the same hostid will cause the old generated license to be retrieved with exactly the same license parameters If you use the Normal fulfillment type for Rehostable licenses you should always use a fixed expiration date not a of days For the Reactivate fulfillment type additional activations on the same activation key are considered reactivations A reactivation will have the same expiration date as the original activation This can be used to allow your customer to move a time limited license to a new host one or more times So for example assume you sell a 1 year license but you would like your customer to be able to move it one time during the year In this case set the activation count to 2 and the activation type to Reactivation Then once your customer creates the first license it will have an expiration date one year out but he can come back sometime later during that year and reactivate the license on another system The new license would expire on the original expiration date If he waited more than one year no new valid license could be generated You should use the Reac
81. um Number of fulfillments from this key integer date For Reactvation original expiration date of the license For string Refresh last date license refreshed lasthostid For Refresh type Last hostid fulfilled stri RLM Activation Pro Manual Page 49 of 68 licf license fulfillment information one row per activation This table is written by both the license generator and rlc Contents column meaning data type id row ID integer akey the activation key string product_id product identifier integer count number of licenses activated integer time time value when activation was done time t integer license hostid hostid for license string hostname hostname on activated machine string remote host IP address typically of machine requesting activation string log Log info from rlm act request call string license generated license For floating licenses this is just the string LICENSE line last fulfill time value at last fulfillment v9 3 time t integer num fulfills Number of fulfillments of this license v9 3 integer revoked license was revoked flag 1 revoked v9 3 integer last fulfill time value when revoked v9 3 time t integer RLM Activation Pro Manual Page 50 of 68 prod product definitions one row per product definition This table is written only by the admin tool Read only by the license generator Co
82. use RLM activation your application contains the URL of the activation server If you are running the activation server at your own website it may be fine to hard code this URL into your software However if you think that there may be a time when you might want to move the website there are a couple of options you can employ to make this change more easily 1 you could create some kind of configuration which your software reads at runtime to decide which URL to use to activate or 2 Youcanusethe ISVNAME ACT URL environment variable to override the activation URL in the rlm activate call see the description of rlm activate in the Reference Manual or 3 youcan set up your URL to redirect to a different presumably newer URL If you use Reprise s hosted activation service Reprise strongly recommends that you employ one of these techniques Obviously the first two techniques are more flexible because they would allow you to continue operating even if the original URL goes away completely This is what Reprise Software recommends If you wish to redirect your URL you can do this with an htaccess file if you are using a linux server with Apache Set up a new domain which you use as your activation URL and redirect the whole domain to the actual activation domain To do this follow these steps e Create the domain usually a subdomain e g activation yourcompany com e In the top level of the domain create a htaccess fi
83. write access to either var tmp isvname on unix mac RLM Activation Pro Manual Page 60 of 68 Status return Problem users application data reprise on Windows Solution systems or documents and settings all RLM_EH_REHOST_TOP_DIR_EXIST S 152 The directory which contains a rehostable hostid for this product already exists so it cannot be created Verify that this product has not already been activated with a rehostable hostid If it has it cannot be activated again on the same machine RLM EH REHOST EXISTS 153 The rehostable hostid already exists for this product so it cannot be created Verify that this product has not already been activated with a rehostable hostid If it has it cannot be activated again on the same machine RLM EH NO FULFILLMENTS 154 No fulfillments exist to revoke An attempt was made to revoke a license which was not activated by this server RLM ACT BAD REDIRECT 1013 HTTP redirect does not specify hostname or can t connect to specified hostname This is a webserver redirect error no redirected hostname was specified or we can t connect to the redirected hostname RLM ACT NO PERMISSION HTTP server did not allow This is a configuration error your license 1018 request to be processed generator cannot run on the webserver REM ACT SER VERSERROR HTTP request returned HTTP The activation server is not con
Download Pdf Manuals
Related Search
Related Contents
MARIN, N. et al. Assistência Farmacêutica para gerentes municipais Ilford 1748165 Samsung GR87 Наръчник за потребителя BENUTZERHANDBUCH MARMITA ELÉCTRICA 50 lt V7 DS1S (オズマ・リー機)リニューアルVer. 取扱説明書 3.0 MB Thermatic Slim.indd "取扱説明書" Bienvenue - Mako Créations Copyright © All rights reserved.