Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision | |||
|
stacker:docs:howtoinstallalicensekey [2019/04/24 23:47] rjlittlefield more clarification about expired trials |
stacker:docs:howtoinstallalicensekey [2024/12/09 02:53] (current) rjlittlefield added: Special information for system administrators |
||
|---|---|---|---|
| Line 29: | Line 29: | ||
| Please do not attempt to re-type the key. That long string of hex digits is very difficult to type correctly by hand. Every character must be exactly correct, or the Enter button will remain disabled. | Please do not attempt to re-type the key. That long string of hex digits is very difficult to type correctly by hand. Every character must be exactly correct, or the Enter button will remain disabled. | ||
| - | + | \\ | |
| + | \\ | ||
| + | \\ | ||
| + | |||
| + | ===== Special information for system administrators ===== | ||
| + | |||
| + | If you are a system administrator who is charged with installing Zerene Stacker on behalf of other users, then you may want to know the following things: | ||
| + | |||
| + | * The license key is always stored as an ordinary file, named "LicenseKey.txt". \\ \\ | ||
| + | * The encoding for the LicenseKey.txt file should be UTF-8. The fact that the file is UTF-8 should be explicitly indicated by adding a single line of ordinary text to the front of the file, containing exactly the 13 characters **Charset:UTF-8** followed by the computer system's normal end-of-line terminator. If that line is not present, then Zerene Stacker will read the file using the computer's default encoding for Java programs. Usually that will work OK also, but it may fail if the license key contains certain special characters. \\ \\ | ||
| + | * The normal method for installing a license key, by using Options > Registrations from within Zerene Stacker, places the LicenseKey.txt file in some designated folder in the current user's file tree. | ||
| + | * On Windows, LicenseKey.txt will go into the user's %APPDATA%\ZereneStacker folder, which typically expands to something like C:\Users\username\AppData\Roaming\ZereneStacker. | ||
| + | * On macOS, LicenseKey.txt will go into the user's ~\Library\Preferences\ZereneStacker folder. | ||
| + | * On Linux, LicenseKey.txt will go into the user's ~\.ZereneStacker folder. This folder is normally hidden because of the leading "." in its name. \\ \\ | ||
| + | * If you wish, the LicenseKey.txt file can also be stored in a specified folder within the installation tree of the Zerene Stacker program. If LicenseKey.txt is stored in this way, then Zerene Stacker will see that license key as valid for all users of the computer, but no user will see the license key in the program's Options > Registration panel. Installing the license key in this way effectively makes most of the key invisible for ordinary users, unless they know where to go looking for it as an ordinary file. In every case, the specified folder is the same folder that holds the ZereneStacker.jar file. | ||
| + | * On Windows, the installation folder is typically C:\Program Files\ZereneStacker, so the license key would go in C:\Program Files\ZereneStacker\LicenseKey.txt . | ||
| + | * On macOS, the installation folder is typically /Applications, so the license key would go in /Applications/ZereneStacker.app/Contents/Resources/Java . | ||
| + | * On Linux, the license key would go in the root of the installation folder, same place as ZereneStacker.jar . | ||