TheScarms(tm) AppSentinel - Installation & Distribution Instructions

 

AppSentinel License Agreement

You should carefully read the License Agreement before installing or using AppSentinel, AppSentinelTrial, AppSentinelAdmin, AppSentinel Control Panel and/or associated documentation ("The Software"). Use of any part of The Software indicates that you understand, accept and agree to be bound by all of the terms of the License Agreement.

 

Extracting AppSentinel Files
  1. Download AppSentinel.zip to a folder of your choice on your development PC.


  2. Open Explorer and navigate to that folder.


  3. Right click AppSentinel.zip and select Extract to to open WinZip (You can get a free copy of WinZip from www.Winzip.com. The following instructions apply to Winzip V8.0 or newer).


  4. Select the folder to extract to (typically C:\Program Files).


  5. Extracting AppSentinel files.

  6. Verify the Use folder names option is selected.


  7. Click Extract.


  8. Close WinZip.


  9. The following folders will be created:

    AppSentinel directory structure


  10. Copy the contents of the WinSys folder to your Windows System folder.


Installing AppSentinelTrial.dll on Your Development PC

AppSentinelTrial.dll is an ActiveX DLL and must be registered with Windows prior to use.

  1. Click the Start button and select Run.


  2. Type the following:

    Regsvr32 AppSentinelTrial.dll

    To install the DLL in another folder, copy it to the desired folder and modify the path accordingly. Example:

    Regsvr32 C:\...\MyFolder\AppSentinelTrial.dll

    Note: "..." may need to be the short (DOS 8.3 format) path to the DLL.


  3. Click OK. The DllRegisterServer in appsentineltrial.dll succeeded message will be displayed. If not, check the path and spelling and try again.
UnInstalling AppSentinelTrial.dll on Your Development PC

Once AppSentinelTrial.dll is registered, it must be unregistered prior to moving or deleting it.

  1. Click the Start button and select Run.


  2. Type in the following:

    Regsvr32 /u AppSentinelTrial.dll

    If the DLL was installed in a folder other than your system folder, modify the path accordingly. Example:

    Regsvr32 /u C:\...\MyFolder\AppSentinelTrial.dll

    Note: "..." may need to be the short (DOS 8.3 format) path to the DLL.


  3. Click OK. The DllUnRegisterServer in appsentineltrial.dll succeeded message will be displayed. If not, check the path and spelling and try again.


  4. You may now delete or move the DLL to another folder. If it is moved, you must again register it as described above.
Adding AppSentinel to Your Application

A complete sample program, written in Visual Basic 6.0 SP5, is provided to show you how to incorporate AppSentinel into your application.

  1. Navigate to the AppSentinel Sample folder.


  2. Double click on AppSentinelSample.vbp to open the sample program in VB.


  3. The code is highly commented and easy to follow.


  4. You can run and step through the sample program once you have registered the DLL.
  • C:\...\TheScarms\AppSentinel\CallingConventions.htm describes all of the DLL's methods and properties.


  • C:\...\TheScarms\AppSentinel\AppSentinelErrors.rtf lists all error messages produced by the DLL.
Using AppSentinelAdmin to Create Registration IDs

The AppSentinelAdmin.dll is used to generate Registration IDs and is meant to be run by you on a computer within your company. The AppSentinel Control Panel is provided for this purpose.

Alternatively, you can create your own interface into AppSentinelAdmin by calling its functionality from your own program or invoking it through a browser via an Active Server Page.

Regardless of how you invoke the DLL, it must first be registered on the development machine or web server on which it resides. To register AppSentinelAdmin, follow the steps outlined in Installing AppSentinelTrial.dll on Your Development PC substituting "AppSentinelAdmin" for "AppSentinelTrial".

  • C:\...\TheScarms\AppSentinelAdmin Samples\VB contains a sample program, written in Visual Basic 6.0 SP5, which illustrates how to call all of the DLL's methods and properties. You can model your own interface after this sample.


  • C:\...\TheScarms\AppSentinelAdmin Samples\ASP shows how to invoke the DLL from an Active Server Page.
AppSentinel Control Panel

The AppSentinel Control Panel invokes the functionality of AppSentinelAdmin to generate Registration IDs.

  1. Verify AppSentinelAdmin.dll is registered as discussed above.


  2. Navigate to the C:\...\TheScarms\AppSentinel folder.


  3. Double click on ControlPanel.exe to run the Control Panel.


  4. Enter a valid Evaluation ID and Machine ID.


  5. Click Calculate Registration ID.
Distributing AppSentinel With Your Application

AppSentinel.dll must be distributed with your application. Your installation package must copy and register the DLL on the target PC. (You are not licensed to distribute the evaluation version, AppSentinelTrial.dll).

To assist in distributing the DLL, the AppSentinel.DEP file located in your system folder contains all file dependency information. Dependent files are the standard files required for a Visual Basic application. If you use the Packaging & Deployment Wizard or Windows Installer to package your application, all necessary information will be read from the .DEP file provided it resides in the same folder as the DLL.


TheScarms(tm) AppSentinel © Copyright 2002 David Scarmozzino
All Rights Reserved
www.TheScarms.com/AppSentinel