home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR21 / COUNT_30.ZIP / COUNT!.TXT < prev    next >
Text File  |  1993-08-19  |  22KB  |  505 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                                 COUNT! v3.0
  23.                                   May 1993
  24.  
  25.  
  26.                        Network Administrators Guide
  27.  
  28.  
  29.  
  30.     This document is intended for Network Administrators and assumes the 
  31.     audience is familiar with MS Windows v3.0 or above, MS DOS v3.3 or 
  32.     above, and basic network management principals.
  33.  
  34.  
  35.  
  36.  
  37.                              Table Of Contents
  38.  
  39.  
  40.                     Topic                             Page
  41.                     ---------------------             -----
  42.                     What is COUNT!                      1
  43.                     Using COUNT!                        2
  44.                     Setting up COUNT! on a network      5
  45.                     Methods of controlling access       5
  46.                     Scrubbing License Files             6
  47.                     USER Messages                       7
  48.                     Registering COUNT!                  8
  49.                     Transferring a License to COUNT!    8
  50.  
  51.  
  52.                                 COUNT! v3.0
  53.                        Network Administrators Guide
  54.                                   Page 1
  55.  
  56.  
  57.                               What is COUNT!
  58.  
  59. COUNT! is a MS Windows utility that enables you to abide to "simultaneous 
  60. use" licenses in a network environment.  This type of license allows you 
  61. to provide applications to a user community without buying a license for 
  62. each potential user.  The result is typically an 80% to 90% reduction in 
  63. the cost of the application.
  64.  
  65. Simultaneous use licenses:
  66.     Unlike mainframe programs which base the fee on the number of 
  67.     potential users of a product, personal computer software licenses are 
  68.     often based on the number of people using a program at any point in 
  69.     time.  If the network provides a dozen applications to 50 users, it is 
  70.     probable that five to ten licenses for each application will be 
  71.     sufficient to meet the needs of the 50 users without purchasing 50 
  72.     licenses of each.
  73.  
  74.     Most major suppliers of personal computer software base their license 
  75.     on simultaneous use.  However, many of these (Microsoft for example) 
  76.     provide no means for maintaining the license.  Should you wind up in 
  77.     court, you are required to provide evidence that adequate precautions 
  78.     were taken to ensure that the simultaneous use license was not violated.
  79.  
  80. What does COUNT! Do:
  81.     COUNT! launches programs in an MS windows environment and keeps track 
  82.     of the number of users.  It will enable you to enforce simultaneous 
  83.     use licenses.  It also provides features to make many programs which 
  84.     function poorly in a network environment behave better.
  85.  
  86.     COUNT! enables a user to access an application as easily as if it were 
  87.     installed on his local hard disk.  To to this, it will if necessary:
  88.  
  89.          Establish a network connection
  90.          Modify the current DOS directory
  91.          Check for license availability
  92.          Execute the program
  93.          Free the network license
  94.          Disconnect the network connection
  95.  
  96. What COUNT! Won't Do:
  97.     There is one possible situation where COUNT! will fail to effectively 
  98.     enforce simultaneouse use licenses.  This would occur if a Windows 
  99.     application primary (loading) executable file (.EXE) terminates before 
  100.     the application does.  COUNT! cannot meter the licensing of such 
  101.     programs since it has no way of knowing when the program ends.  It is 
  102.     also arguable that any such application would be impossible to meter 
  103.     licenses for.  I am not aware of any major commercial application 
  104.     software that exhibits this behavior.
  105.     
  106.     I mention this only should you encounter problems using COUNT!
  107.  
  108.  
  109.                                 COUNT! v3.0
  110.                        Network Administrators Guide
  111.                                   Page 2
  112.  
  113.  
  114.                                Using COUNT!
  115.  
  116. An end user needs no special knowledge to use COUNT!  He simply launches 
  117. applications normally through Windows.  A license dialog box appears 
  118. informing him the license is being shared.  If no more licenses are 
  119. available, the dialog box will inform him of that and provide a list of 
  120. current users.
  121.  
  122. In setting up applications to run under count, A network administrator 
  123. needs to:
  124.         1) Set up an environment on user PCs where Applications are 
  125.            launched through COUNT! rather than directly.
  126.         2) Create a COUNT!.INI file which controls how Count! launches 
  127.            applications.
  128.  
  129. To launch applications through COUNT! you need to be familiar with the 
  130. Windows Program Manager, and the methods to launch applications.  The most 
  131. common method for the user to "double click" on an application icon in a 
  132. Program Manager group.  The second is to use the file manager to launch an 
  133. application with a selected data file.  A third is to launch the 
  134. application using the Program Manager's "Run command".  You do not need to 
  135. support all methods as a network administration manager.  All are covered 
  136. below.
  137.  
  138. Using the COUNT! Command Line:
  139.     To support any of the above, you need to use a valid COUNT! comand 
  140.     line.  The launched application is a parameter for COUNT!.  For 
  141.     instance, to launch Microsoft's Excel, the program line could be 
  142.     "COUNT!  MS_Excel".  To launch Aldus' Persuasion, the program line 
  143.     could be "COUNT!  Persuasion".  COUNT! would then do everything 
  144.     necessary to make appropriate network connections, start the 
  145.     application, and enforce software licenses.
  146.  
  147. Supporting Applications Launched via a Program Manager Application Icon:
  148.     You will need to modify the vendor supplied installation procedure to 
  149.     modify the icon's "properties" to use COUNT! to launch the program.
  150.  
  151.     The application icon program line properties can be changed using the 
  152.     following procedure:
  153.  
  154.          In Program Manager, select the program icon by clicking on it 
  155.          once with the mouse.
  156.  
  157.          Select File-Properties, from the Program Manager's menu.  A 
  158.          "Program Item Properties" dialog box should appear.
  159.  
  160.          Change the command line in the dialog box to launch the program 
  161.          through COUNT!  ie.  "COUNT!.EXE MS_Excel".
  162.  
  163.  
  164.                                 COUNT! v3.0
  165.                        Network Administrators Guide
  166.                                   Page 3
  167.  
  168.  
  169.          You should also change the icon to the application's normal icon, 
  170.          which is typically in the main .EXE file of the application.  
  171.          This is also done from the "Program Item Properties" dialog box.
  172.          Press the "Change Icon" button and type in the file name 
  173.          containing the Icon (ie. E:\EXCEL\EXCEL.EXE)
  174.          
  175.          The Program .exe file may not be available to Windows if the 
  176.          network drive is not currently connected.  In this case you can 
  177.          substitute an icon from PROGMAN.EXE or MORICONS.DLL.  You could 
  178.          also use a 3rd party utility to extract an icon from an 
  179.          application .exe file, and make the icon file available to Windows.
  180.  
  181. Supporting Applications Launched via File Manager:
  182.     You need to modify the "[extensions]" section of WIN.INI to associate 
  183.     COUNT! with the extension of data files your program runs.  Again, you 
  184.     must supply a command line such as "XLT=COUNT!.EXE MS_Excel ^.XLT".  
  185.     Modifing user .INI files can be automated by using the Fix_INI! 
  186.     program which accompanies Count!
  187.  
  188. Supporting Applications Launched via Program Manager's Run Command:
  189.     The user would have to enter a correct COUNT! command Line in Program 
  190.     Manager's "RUN" dialog box.
  191.  
  192.  
  193. How COUNT!.INI Controls the Launching of Applications:
  194.     The COUNT!.INI file controls what COUNT! does in launching an 
  195.     application.  COUNT!.INI is created and maintained by the Network 
  196.     Administrator using any ASCII editor, such as NotPad.  It consists of 
  197.     a number of applications "Sections" containing keywords describing how 
  198.     to launch the application.  Each section begins with the 
  199.     ApplicationName in square brackets.  You can use any ApplicationName 
  200.     you like so long as it is less than 32 Characters.  Keywords can be 
  201.     any of the following:
  202.  
  203.          ConnectDrive=Drive:,Network_Path,Password
  204.              (Only Windows 3.1 and above support this command.  You can 
  205.              use "Connect" to support Windows 3.0)  The Password is 
  206.              optional.  However, the comma separator must be included.  
  207.              You can use "*" as the Password and the User will be prompted 
  208.              to provide one.  If The Drive and Network service are already 
  209.              in use, this command is ignored.  Network Drives which are 
  210.              connected with this command are Disconnected when the the 
  211.              user exits the application unless DisConnectDrive=No.
  212.          DisConnectDrive=Yes or No.
  213.  
  214.  
  215.                                 COUNT! v3.0
  216.                        Network Administrators Guide
  217.                                   Page 4
  218.  
  219.          Connect=Network connection command (you would issue at a DOS prompt.)
  220.              The Connect and Disconnect KeyWords are provided to support 
  221.              Windows 3.0, or for Networks incompatible with Windows 3.1 
  222.              network management features.
  223.          Disconnect=Network disconnection command
  224.          StartDirectory=Starting directory.  This will overRide any 
  225.              directory specified in a Program Manager's Icon Properties.
  226.          Execute=Program invocation command.
  227.          CountFile=R/W file which holds the current users/license counts.
  228.          MaxUsers=Number of users that can use the program simultaneously.
  229.          MaxTime=Number of minutes of program use before Count! reminds the 
  230.              user to free the application license.
  231.          UpdateLicense=Number of minutes between updates of the
  232.              CountFile.  The default is 5.  A 0 inhibits updates.
  233.  
  234.          All keywords other than Execute are optional.
  235.  
  236.  
  237.     If a CountFile is used, A DOS environment variable must exist prior to 
  238.     entering Windows which provides a user name.  This is accomplished by 
  239.     the DOS SET command as follows:
  240.          "SET Name=UserName"
  241.  
  242.     The UserName must be unique to each network node.  It is typically 
  243.     assigned in a the Autoexec.Bat or Network Startup File.
  244.  
  245.     Below is an example COUNT!.INI file.
  246.  
  247.          [MS Excel]
  248.          Connect=USE E:\\MyServer\ExcelProgram /R
  249.          Execute=E:\EXCEL\Excel.EXE
  250.          Disconnect=USE E: /D
  251.  
  252.          [MS Project]
  253.          ConnectDrive=L:,\\MyServer\MSProject,,
  254.          Execute=L:\WinProj\Project.EXE
  255.          StartDirectory=c:\Project
  256.          CountFile=Q:\Licenses\Licenses.Dat
  257.          MaxUsers=10
  258.          MaxTime=120
  259.  
  260.  
  261.                                 COUNT! v3.0
  262.                        Network Administrators Guide
  263.                                   Page 5
  264.  
  265.  
  266.                       Setting Up COUNT! on a Network
  267.  
  268. COUNT!.EXE and COUNT!.INI need to be placed in a common network directory 
  269. accessible to all users.  Users should be granted READ ONLY access to 
  270. these files.
  271.  
  272. If a CountFile is used to monitor or meter access (via MaxUsers), a common 
  273. user READ\WRITE area needs to be made available for this file. COUNT! will 
  274. create the CountFile as required.
  275.  
  276. Also, as mentioned previously, A DOS environment variable must exist 
  277. (NAME=UserName) if a CountFile is used.  It is suggested that this be 
  278. created in each nodes AutoExec.Bat or Network Connection.Bat file.
  279.  
  280.  
  281.                        Methods of Controlling Access
  282.  
  283. There are two ways to use COUNT! to enforce simultaneous use licenses.  
  284. One method is to put each application you want to control access to in a 
  285. unique network file service, and place a limit on the number of 
  286. connections to this service.  COUNT! could then connect to the service 
  287. before starting the program, and disconnect when done. The server would 
  288. preform the license counting/metering.
  289.  
  290. The above method is the most secure method of controlling access.  However, 
  291. there may be situations in which you cannot or prefer not to create unique 
  292. network services for each application.  You can then use COUNT!'s MaxUsers 
  293. keyword to control access.  You can use both methods sinultaneously if you 
  294. want to provide users with friendlier error Messages when denied access to 
  295. applications.
  296.  
  297. When a program is launched, COUNT! first checks the CountFile (if 
  298. specified) to see if the number of current users is less that the MaxUsers 
  299. defined in COUNT!.INI for that application.  If so, COUNT! adds an Entry 
  300. to the CountFile similar to the one below:
  301.  
  302.          [MS Project]
  303.          John Doe=09:33:27 02/12/92
  304.  
  305. The timestamp is updated every 5 minutes unless overridden with the 
  306. UpdateLicense Keyword.  The Entry is removed when the user exits the 
  307. application.
  308.  
  309. If no Licenses are available when using a CountFile, the user will get a 
  310. list of currently active license holders.
  311.  
  312.  
  313.                                 COUNT! v3.0
  314.                        Network Administrators Guide
  315.                                   Page 6
  316.  
  317.                           Scrubbing License Files
  318.  
  319. If you use a CountFile, you will need to periodically maintain the file to 
  320. remove inactive licenses.  Licenses become inactive when applications are 
  321. terminated abnormally, such as rebooting the PC while the application is 
  322. in use.  When this occurs, the license file entry for that user is not 
  323. freed until that same user runs and exits the application again.
  324.  
  325. The CountFile could be maintained with any ASCII editor by deleting lines 
  326. identifing inactive licenses.  There is an easier way for registered users 
  327. of COUNT! v3.0 and above.  A supplimental program, SCRUB.EXE, is supplied 
  328. which can periodicallly be run to automatically remove inactive licenses.  
  329. In addition, Count! will start SCRUB whenever a User is denied access to 
  330. an application for lack of an available license.
  331.  
  332. SCRUB works by examining the CountFile, waiting a specified time and then 
  333. reexamining it.  If the license entries are not updated in that time, they 
  334. are assumed to be inactive and removed.  By default SCRUB waits for the 
  335. UpdateLicense interval+1 minute.  The extra minute allows for programs 
  336. which might take total control of the PC for some period of time.  For 
  337. instance, If Excel takes several minutes to recalculate a spreadsheet, it 
  338. may not allow COUNT! to update the CountFile during that period.  (Windows 
  339. 3.x is Not Pre-emptive.)
  340.  
  341. If you feel 1 minute is not sufficient, you can override this by specifing 
  342. an interval in COUNT!.ini  Add a section called [SCRUB] in the file, 
  343. followed by lines containing AppName=Interval.  An interval less than 
  344. UpdateLicense + 1 minute will be ignored.  A interval of 0 will disable 
  345. Scrubbing for the specified application.
  346.  
  347. When SCRUB is running, an Icon identifing the time remaining will be 
  348. displayed on the Windows Desktop.
  349.  
  350. As mentioned, COUNT! will automatically run SCRUB when a user is denied 
  351. access to an application due to lack of an available license.  In 
  352. addition, a Network Administrator may want to periodically run SCRUB, 
  353. perhaps placing it in his/her Windows startup group.
  354.  
  355. If Scrub is run without any parameters, it will Scrub the Countfile of all 
  356. applications listed in the [SCRUB] section of COUNT!.ini  If you need to, 
  357. you can scrub an individual application by including it as a parameter on 
  358. SCRUB's command line.  (i.e. "SCRUB MS_Excel")
  359.  
  360.  
  361.                                 COUNT! v3.0
  362.                        Network Administrators Guide
  363.                                   Page 7
  364.  
  365.                               USER Messages
  366.  
  367. There are a few messages COUNT! passes to the user that a Network 
  368. Administrator needs to be aware of.  These are covered below:
  369.      
  370.        "All Licenses for this application are currently in use!"  A user 
  371.         will get this message when all licenses set by the MaxUsers 
  372.         parameter are in use.  They will also get a list box identifing 
  373.         users so they can try to free up a license on their own.
  374.      
  375.        "Please Exit AppName IMMEDIATELY!  License VIOLATION!"  Through an 
  376.         Application error or user tampering, the license reserved for this 
  377.         user in the CountFile has been erased.  A user should Never get 
  378.         this message.  It sould be looked into by the Network 
  379.         Administrator.
  380.  
  381.        "You have exceeded the recommended time limit for this application
  382.         and are reminded to free this license when you are finished so 
  383.         that others may use the program."  A user will get this message if 
  384.         he uses the program beyond the MaxTime variable.
  385.  
  386. The remaining messages should not normally be seen by a user, but may 
  387. arrise in setting up applications to run under COUNT!
  388.  
  389.        "Could Not Connect (to Drive)"  A network Error caused by an 
  390.         incorrect DOS drive or Network file service specification in 
  391.         COUNT!.ini, or unidentifable network connection problem.
  392.  
  393.        "Drive In Use on Different Service"  A failure to connect to the 
  394.         requested network service in COUNT!.ini because the requested Drive 
  395.         is already being used for a different network service.  You should 
  396.         not set up two network applications to share a DOS drive letter 
  397.         for different file services.
  398.  
  399.        "Could Not Execute"  Execution of the application failed.  Most 
  400.         often this is caused by an error in COUNT!.ini or perhaps a DOS 
  401.         PATH Error.
  402.  
  403.        "Could Not Find Count!.ini"  COUNT!.ini is not in the same 
  404.         subdirectory as COUNT!.exe.
  405.  
  406.        "No Application Specified"  No ApplicationName was specified on the 
  407.         COUNT! Command Line.
  408.  
  409.        "No Program to Execute in Count!.Ini"  No "Execute=" was included.
  410.  
  411.        "Name Environment Variable Not Defined!"  You MUST have a Name 
  412.        Environment Variable defined if you are using a CountFile.
  413.  
  414.  
  415.                                 COUNT! v3.0
  416.                        Network Administrators Guide
  417.                                   Page 8
  418.  
  419.  
  420.                             Registering COUNT!
  421.  
  422. COUNT! is copyrighted software and all rights are reserved by the author.  
  423. You are free to evaluate the product for 30 days to determine its 
  424. suitability to your needs.  Use beyond 30 days requires registration.
  425.  
  426. Anyone with the conscience to use COUNT! will want to register it.  A 
  427. license to COUNT! enables you copy and use the software on a single server 
  428. for up to 100 Users.  The cost of the license is $59.  If you would like 
  429. to register, please fill out the form on the next page.
  430.  
  431. In return, you will be sent a diskette with a registered version of the 
  432. software.
  433.  
  434.                       Transferring a License to COUNT!
  435.  
  436. Upon registering, you will receive a license number.  To license the 
  437. software, you will need Read/Write access to the directory where 
  438. COUNT!.EXE is located.  From Windows Program Manager, use "File Run" and 
  439. place in the command Line "Drive:\Path\COUNT!.EXE /L".
  440.  
  441. You will prompted you for your company and server name.  You are limited to 
  442. a total of 50 characters, so you may have to abbreviate.  If the name 
  443. appears truncated in the Main dialog box, you can reinstall the license.
  444.  
  445.  
  446.                             COUNT! v3.0 User Registration
  447.  
  448.      NAME:             ____________________________________
  449.  
  450.      Company:          ____________________________________
  451.  
  452.      Street:           ____________________________________
  453.  
  454.      Town, State, Zip: ____________________________________
  455.  
  456.  
  457.      Please register me for (____) copies of COUNT!.  Enclosed is $59.00 for
  458.      each copy (plus 6% Sales tax for Maine residents).
  459.  
  460.      Preferred Media:  5.25"(360K) ____  3.5" (720K) ____
  461.  
  462.      Please make checks payable to:
  463.                        Edward Derzawiec
  464.                        6 Sweet Fern Road
  465.                        Cape Elizabeth, ME  04107
  466.  
  467.      Signature:   ____________________________________
  468.  
  469.      In signing this form I agree:
  470.           1. Not to make copies of the registered software received for
  471.              purposes outside of my use on a single network server.
  472.  
  473.           2. Not to modify the software without written consent of the author.
  474.  
  475.      I welcome your comments on the merits or limitations of COUNT!, or
  476.      enhancements you would like to see added.
  477.  
  478.          _______________________________________________________________
  479.  
  480.          _______________________________________________________________
  481.  
  482.  
  483.      To improve the testing of COUNT!, please answer the following:
  484.  
  485.          Server Type:
  486.               Operating System: DOS ____, OS2 ____, VMS ____, UNIX ____
  487.                                Other _________________
  488.  
  489.               Network OS:  Novel ____, Vines ____, PCSA ____, Other ________
  490.  
  491.          Nodes:
  492.               PC/XT (8086/8088) ____,   AT (286) ____,  (386/486/SX CPU) ____
  493.               Display: Mono, ____, CGA, ____ EGA, ____ VGA, ____  Color ____
  494.               Windows Version ____
  495.  
  496.          Applications Count! is Used For:
  497.               
  498.                ______________________________________________________________
  499.  
  500.      ========================================================================
  501.      Do not write below this line:
  502.  
  503.          Serial number licensed to above user: ____________
  504.  
  505.