---------------------------------------------------------------------- LOCKER Plus v2.00 Demo Thank you for Trying LOCKER Plus v2.00 for DOS & WINDOWS. Please notify us if you encounter any problems with LOCKER. You are allowed to use this DEMO of LOCKER for 30 days. After 30 days you should either purchase LOCKER or STOP USING the DEMO. You are allowed to give/distribute this demo to anyone ONLY IF it is given with this documentation and is FREE. We are interested in what you think about LOCKER - what additional feature you would like to see, what you don't like about it, and what you do like about it. Depending on what feedback I receive, additional features may be added ! ---------------------------------------------------------------------- Current versions of LOCKER available Locker v2.00 Meters both DOS & WINDOWS programs, has a windows based LOCKCON, can meter office suites, and has the ability to support add on modules for metering NT and OS/2 programs Locker Plus v2.00 has all the features of v2.00 plus virus detection & notification, ability to set a waiting timeout from unlimited to none, an user audit trail with date-time stamp / program name / # of concurrent users at that time, improved reporting and more Other Products: LanSync v1.00 Software Distribution LanSync allows you to make a distribution image of a program either by manual specification (of the files and changes needed) or via automatic determination. It can update the clients autoexec.bat, config.sys, Windows INI, Window Registration Database, Program Manager Groups, and copy files and directories to the client pc. Distribution is via an executable which can be email to all users that require the Distribution. LanMenu v1.00 Windows Menuing System Creates a floating window bar which contains up to 10 tab groups. Each group can contain upto 10 icons which when pushed start up the corresponding program, pif file, etc. Users only see the groups and the programs they are entitled to. ---------------------------------------------------------------------- The following licenses for LOCKER are available: LOCKER v2.00: USD $135 / server LOCKER Plus v2.00: USD $175 / server LOCKER Plus for NFS v2.00: USD $175 / server LanSync v1.00: USD $175 / server LanMenu v1.00: USD $ 85 / server (S/H included) for the US & CANADA In Massachusetts please add 5% Sales Tax. We accept MasterCard, Visa, Company PO's (call for approval), Company Checks and Money Order If you want more information on any product or you wish to purchase a product we can be contacted at: HAMPSHIRE SOFTWARE 300 Washington Street Box 216 N. Pembroke, MA 02358 SALES: (617) 447-8606 / (800) NET-SOFT TECH Support: (617) 447-8607 FAX: (617) 447-0141 BBS: (617) 447-2271 (300-14.4 N-8-1) Compuserve Address: 72607, 3042 Internet: 72607.3042@compuserve.com NETSOFT@aol.com Dealer / Reseller inquires welcomed. And NOW for the usual disclaimers: NO OTHER WARRANTIES. HAMPSHIRE SOFTWARE disclaims all other warranties, either express or implied, including but not limited to implied warranties of mechantability and fitness for a particular purpose, with respect to the software, the accompanying written materials, and any accompanying hardware. This limited warranty gives you specific legal rights. You may have others, which vary from state to state. NO LIABILITY FOR CONSEQUENTIAL DAMAGES. In no event shall HAMPSHIRE SOFTWARE or its suppliers be liable for any damages whatsoever caused by the use of or inability to use this HAMPSHIRE SOFTWARE product. Because some states do not allow the exclusion or limitation of liability for consequential of incidental damages, the above limitation may not apply to you. ---------------------------------------------------------------------- Table of Contents Chapter 1: 1.1 What is Locker 1.2 Requirements Chapter 2: 2.1 Upgrading 2.2 New Installation Chapter 3: 3.1 Screen layout and commands 3.2 Installing metering on software 3.3 Changing metering limits on software 3.4 Removing metering from software 3.5 Office Suites & Groups 3.6 Metering applications which reside on local drives Chapter 4: 4.1 Common Mistakes & Problems 4.2 What not to do CHAPTER 1: INTRODUCTION 1.1 What is LOCKER LOCKER is a program which meters software on a network. It controls the number of users that may run a DOS or WINDOWS executable (*.COM & *.EXE LOCKER is run from a console from which you can: Add metering to a program, Change the metering limit on a program, Remove the metering from a program, Be notified of any license violation or virus detections See the active users of a program, See the number of active users for a program, See what the peak number of users was for a program, See the number of times a user had to wait to run a program See the number of times a user canceled out of waiting for a program to be available. You should check the licensing agreement for the software that you are installing metering on, some licensing requires that you own a copy of t LOCKER works with most DOS based networks which support DOS file sharing and locking. It has been tested with Novell's Netware, Banyan's Vines, 1.2 Requirements LOCKER requires DOS 3.3 or higher and Windows 3.1, while it may work with older versions of DOS, we cannot guarantee that it will. LOCKER adds CHAPTER 2: INSTALLATION 2.0 What you need to remember after installing metering DO NOT erase any hidden files which reside in the applications directory after installing metering. Locker uses these files and if they are rem DO NOT erase the LOCKCON files before removing metering on all metered applications. The applications will still be metered after LOCKCON is re 2.1 Upgrading You should remove metering from all programs you are currently metering. Then proceed with the normal install except you should copy the LOCKER 2.2 New Installation This installation assumes some knowledge of DOS. If you have problems with the commands, please look them up in your DOS manual. First copy the LOCKER disk to a drive\directory where only the SUPERVISOR or NETWORK ADMINISTRATOR has access. For example: Copy A:*.* F:\SYSTEM\*.* Now startup windows Open up the group you wish to add the LOCKER management console to (LOCKCON) and then select File/New the Program Manager window. Then press OK Example: {EMBED MSDraw \* mergeformat|} Next startup the LOCKCON Program by double clicking on its it. After starting LOCKCON (for the first time) you will see the following screen: {EMBED MSDraw \* mergeformat|} For the log file drive\path you should enter a directory (it does not need to currently exist) where all your users will have full access to. F Please Note: That for all paths that are entered via LOCKCON you should use the standard DOS paths not network specific paths (for example: do You have now installed LOCKER and are ready to start metering you applications. CHAPTER 3. USING LOCKER 3.1 Screen Layout and commands To run LOCKCON double click on its icon. This will bring up Locker's console: For each program being metered you will see the following information: PROGRAM: Either the program executable file name or the description TYPE: Whether a program is a DOS or WINDOWS (DOS/WIN) based LIMIT: How many users can use the program concurrently CURRENT: How many users are currently using the program OVER: How many times the license was violated PEAK USED: Peak number of concurrent users WAITS: Number of users who had to wait to access the program CANCELS: Number of users who canceled out of waiting for the program to be available TOTAL ACCESS: Number of times the program has been run From LOCKCON you can either install metering on software, change the metering limits or remove metering from software. Actions you can do from this screen: To install metering on a software product press Install Metering Button To highlight a displayed software product use the arrow keys or single click on the item To change the metering limit, first highlight the software name and then press the Edit Metering Button or double click on the item To remove metering from a software product, first highlight the software name and then press the Remove Item Button To add a Office Suite / Group push the Install Suite Button To see the current users for a program, press the Users Button (The DOS Environment variable you are using to get the ID from must first be specified in File/SetConfig To edit the metering limit of a suite or add/remove items in it, double click on the suite or highlight and press the Edit Metering Button To clear the log information select Edit/Clear Log from the menu To Clear all the logs select Edit/Clear all Logs from the menu To print a report of the metered items select File/Print Log Info from the menu To export the information in Locker to a comma delimited file select File/Export Log Info from the menu To print the audit log for a program, first highlight the program and then select File/Print Usage Report To display the audit log for a program, first highlight the program and then select File/Display Usage Report To print a statistical/graphical report for a program, first highlight the program and then select File/Print License Report To display a statistical/graphical report for a program, first highlight and then select File/Display License Report To set the DOS environment variable from which the UserID is gotten select File/SetConfig To force the screen to update the log information select Edit/Update (or F3) To toggle whether the screen is updated, select Edit/Update Toggle (or F2) To exit from LOCKCON select File/Exit from the menu 3.2 Install metering on software After pressing the Install Metering Button an entry screen will be displayed: Program : This is the software executable name (for example: TEST.EXE - do not include that program path). Program Desc: This is a description of the item being metered Program Path: Enter either the directory or the drive:\directory of where the software is located. Please note that you should have the same Module name: Leave it blank unless the main program actually starts another module/program and then terminates. (Only used for windows progr Type: What type of program you are metering. Normally either Windows or DOS program). Limit: The maximum number of concurrent users allowed. Scan Time: Enter how often you want the program to check to see if a license is available. Timeout: How long can a user wait for a program to be available. 0 = No waiting allowed, Blank = Unlimited waiting. Log: This field controls whether the extended log information is kept. Virus Detection: This field controls whether Locker will check to see if a virus has infected the exe (only will find viruses after which in Allow Violations: Allow Violations to occurs but keep track of the total number of violations After you are finished entering the information, you can either escape from adding metering by press CANCEL or install metering by press SAVE. 3.3 Changing metering limits on software After highlighting the software you wish to change the metering on and pressing Edit Metering Button the same screen as when you installed the 3.4 Removing metering from software After highlighting the software you wish to remove the metering from and pressing the Remove Metering Button you will be prompted as to whether 3.5 Office Suites / Groups Before you can meter any programs in a Office Suite you must first install the basic suite information. This is done by pressing the Install Su Suite/Group Desc This is a description of the Office Suite Limit: The maximum number of concurrent users allowed for the suite. Scan Time: Enter how often you want the program to check to see if a license is available. Timeout: How long can a user wait for a program to be available. 0 = No waiting allowed, Blank = Unlimited waiting. Virus Detection: This field controls whether Locker will check to see if a virus has infected the exe (only will find viruses after which in Allow Violations: Allow Violations to occurs but keep track of the total number of violations Log: This field controls whether the extended log information is kept. Press SAVE to save the information or CANCEL to exit with adding an office suite. After adding a Suite there will now be an item the type GRP in the LOCKCON screen. To add/remove metering to programs in this suite or change t This will bring up the Edit Suite Dialog Box: To change the user limit, enter the new limit and press SAVE. To add metering to a program in the suite Press the Install Metering Button. To remove metering from a program in the suite press the remove metering button. 3.6 Metering applications on Local hard drives There are two way of metering applications residing on local hard drives 1) You can either install the application on the network, install metering, and then copy all the files to the each local hard drive (Make cer 2) Install the application on the local drive, copy the executable file to its own directory on the network, install metering on the executable After changing the metering limits for applications residing on local drives you DO NOT have to redistribute the network files. After removing metering from an application residing on a local drive you must either erase all copies of the application which reside on the l Chapter 4: ERROR MESSAGES 4.1 Common Mistakes & Problems Most of the problems will be covered by the messages below. Since LOCKER does run on a wide variety of networks, you might get a problem which If you are using Norton's Desktop for Windows you will need to make the .@@@ file unhidden. ex. Attrib TEST.@@@ -H For WORD PERFECT v5.1 for windows, you need to copy the WPWINFIL.EXE file in the WordPerfect directory to WPWINFIL.@@@ before installing meter ex. copy F:\wp51\wpwinfil.exe f:\wp51\wpwinfil.@@@ For WORD PERFECT v6.0a for windows, you need to copy the WPWIN60.EXE file in the WordPerfect directory to WPWIN60.@@@ before installing meteri program name: WPWIN.EXE and for the module name: WPWIN60.@@@ If you are moving all files from one File Server to another, make certain you unhide all files in the LOCKER log directory and each program dir The supervisor can run a metered program but the users can not. You have not granted rights to the log file path directory. (This is the dire Metering was installed but the program still allows everyone to access it. The program probably starts another program and then exits. You sho You are having difficulty metering windows. You should install metering on progman.exe (its a windows program) instead of win.com or win.exe. LOCKCON Error Messages: ERROR-001 : Error renaming the unmetered program - it may be in use by someone. Check to see if anyone is running it and have then quit the pr ERROR-002 : Unable to open the Locker metering stub. Check to see if you have a LOCKER.WIN or LOCKER.DOS file in the LOCKER directory. ERROR-003 : Unable to create an metered program stub ERROR-004 : An error occurred during the copying of the program stub. ERROR-005 : Locker was unable to create the extended log information file in the log file directory ERROR-006 : Locker was unable to open LOCKER.LOG file in the Locker directory ERROR-007 : An error occurred while copying the LOCKER.LOG file to the extended log file in the log file directory ERROR-008 : Locker was unable to create the metering control file in the log file directory ERROR-009 : Locker was unable to open the LOCKER.MET file in the Locker Directory ERROR-010 : An error occurred while copying the LOCKER.MET file ERROR-013 : Locker was unable to create in the log file directory the metering information for the program ERROR-014 : An error occurred during the writing the metering information file ERROR-011 : Locker was unable to create a file with the extension of .~LK in the program directory. ERROR-012 : An error occurred while writing to the .~LK file ERROR-014 : Was not able to find the program to remove metering from. Check to see if the path originally specified for the program is still v ERROR-15 : It looks like the metering for this program is no longer valid. Check to see if you have a file in the programs directory with the ERROR-16 : Locker was unable to delete the metered program to restore it with the unmetered version ERROR-17 : Locker was unable to rename the unmetered version back to the original name ERROR-021 : Locker was unable to open the metering information file. (.@DT) ERROR-022 : An error occurred while reading from the metering information file ERROR-023 : A seek error occurred with the metering information file ERROR-024 : An error occurred while writing to the metering information file ERROR-041 : Locker was unable to create the LOCKER.CFG file in the locker directory ERROR-042 : An error occurred while writing to the LOCKER.CFG file ERROR-050 : Locker was unable to create a file indicating that the program was a member of a suite ERROR-051 : An error occurred during the writing to the suite location file 4.2 What not to do: DO NOT erase any hidden files which reside in the applications directory after installing metering. Locker uses these files and if they are re DO NOT erase the LOCKCON files before removing metering on all metered applications. The applications will still be metered after LOCKCON is r