Академический Документы
Профессиональный Документы
Культура Документы
=====================================================================
IMPORTANT NOTE:
CrypKey Stealth can attach the CrypKey License Service for automatic
installation. If you choose to use that option you may largely skip the
contents of this file and instead use the Stealth documentation.
1. Files
========
1) In the process termination code, which can be read by the process that
launched SETUPEX.EXE, if supported by your installer development tool.
2) The error code is also written in ASCII to the file SETUPEX.XCO at
termination to for use by developement tools not supporting method #1.
Some Installer programs are not able to receive the error code via either
method. This is OK as processing of the error code optional, although CrypKey
recommends you not use the /S switch if the error code is not processed.
// SetupEx.exe is being run from a remote drive. The CrypKey License Service
// is not required on the computer that SetupEx.exe is being launched on.
//
// or a permissions error blocking the installation.
NTDRVR_INSTALL_ERR_REMOTE_DRIVE -2
// This error usually occurs when the user does lacks permission to load
// drivers, typically fixed by logging in as a local administrator or,
// in Vista, launching Setup.Ex.exe using the Administrator account.
NTDRVR_INSTALL_ERR_REG_COULD_NOT_OPEN_SERVICEMANAGER -8
// A -17 error is more a warning. Your install should simply note this and
// strongly encourage the user to restart Windows at the end of the
// install. CrypKey License Service will be ready after the reboot. This
// normally occurs if the CrypKey License Service was already installed
// and the kernel driver is being updated.
// A -17 will also be reported if the /D switch was specified and this was
// the last applications registered with the CrypKey License Service.
// In the case of an uninstall the restart is still important as an attempt
// to reinstall CrypKey License Service before a restart will fail.
NTDRVR_INSTALL_ERR_REBOOT_NEEDED -17
2.2 Installing
Usage: SetupEx.EXE
The easiest strategy is to copy SetupEx.exe and CKS.exe into the directory
where the file to be protected is being placed and then launch this
copy of SetupEx.EXE.
The one exception is that if run on Windows 95/98 SetupEx.exe will silently
terminate without a error dialog box and without performing an installation.
Usage: SetupEx.EXE /S
In this mode, SetupEx.EXE will not put any dialogs on the screen.
It will do complete checking, and install if it can, and return an
error code if it can't.
Usage: SetupEx.EXE /F
The install will have no action if there is a driver with the same or a
more recent date already installed. However, you can force an older driver
to install by using the /F option.
2.3 Uninstalling
Usage: SetupEx.EXE /D
If there are no other programs using the driver, the uninstall will
stop the service, remove the files used by the CrypKey License Service, and
notify
the user via a model dialog box that restarting Windows is required.
Note that it if the user does try to do another install before booting,
and the service was removed, they will get an error -9:
"Register Directory: Unable to open CrypKey License Service
Reason: The specified service does not exist as an installed service"
Usage: SetupEx.EXE /U
This will always stop the service, remove the CrypKey License Service files,
and
notify the user via a model dialog box of the requirement to restart Windows.
The other applications registered with the CrypKey License Service, if any
were,
will remain so even after you re-install the CrypKey License Service using
SetupEx.exe,
after first restarting Windows.
However until an install can be performed again these applications will not be
able to use CrypKey authentication due to the lack of a functioning CrypKey
License
Service to serve them. Because of this it is recommended that /D be used in
release
versions, and /U be used for test purposes only.
Usage: SetupEx.EXE /D /S
SetupEx.EXE /U /S
You can prevent the restart required dialog box, or any error, being shown
using the
"silent mode". This functions the same as with an install.
3. Behavior of Operation
========================
The CrypKey License Service Install will install all necessary files, register
the files for automatic startup on reboot, and start the driver.
4. Revision History
===========================
2006-Mar-02
Driver updated to auto start activer server processes on driver start up.
Driver will also shut down server processes when it is shut down.
2007-May-25
Support added for both 32-bit and 64-bit Vista. No change in use is required.
SetupEx.exe automatically detects when it is being run on x64 Vista and
installs the required 64-bit kernel binary in place of the 32-bit one.
We have received reports that the CrypKey License Service functions without
issue on x64 versions of Windows other than Vista, although CrypKey does not
offically support those platforms at this time.
2007-Oct-02
SetupEx.exe and CKS.exe are now signed using a Verisign certificate, and
SetupEx.exe has a manifest that tells Vista it requires Admin privileges.