Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
stacker:docs:linux_installation_instructions [2017/05/15 00:28] rjlittlefield |
stacker:docs:linux_installation_instructions [2023/11/12 19:25] (current) rjlittlefield troubleshooting: added 32- versus 64-bit problem |
||
---|---|---|---|
Line 1: | Line 1: | ||
====== Linux Installation Instructions ====== | ====== Linux Installation Instructions ====== | ||
- | The current distribution package for Linux consists of a .zip archive that unpacks to produce a hierarchy of files as follows: | + | The current distribution package for Linux consists of a .zip archive that unzips to produce a hierarchy of files as follows: |
<code> | <code> | ||
ZereneStacker top level directory | ZereneStacker top level directory | ||
Line 9: | Line 9: | ||
ZereneStacker.jar jar containing the application | ZereneStacker.jar jar containing the application | ||
JREextensions directory containing numerous .jar files | JREextensions directory containing numerous .jar files | ||
- | jre directory containing a Sun Java Runtime Environment for Linux | + | jre directory containing a Java Runtime Environment for Linux |
(32-bit or 64-bit as appropriate) | (32-bit or 64-bit as appropriate) | ||
</code> | </code> | ||
Line 17: | Line 17: | ||
For your convenience in using the package later, you may also want to create a "launcher" icon that will provide launch by double-click without the confirming dialog. The procedure for doing that depends on what version of Linux and what desktop manager you're using. Some helpful guidance is provided [[http://askubuntu.com/questions/64222/how-can-i-create-launchers-on-my-desktop|HERE]] at askubuntu.com. | For your convenience in using the package later, you may also want to create a "launcher" icon that will provide launch by double-click without the confirming dialog. The procedure for doing that depends on what version of Linux and what desktop manager you're using. Some helpful guidance is provided [[http://askubuntu.com/questions/64222/how-can-i-create-launchers-on-my-desktop|HERE]] at askubuntu.com. | ||
+ | |||
+ | Troubleshooting: We have seen a couple of things go wrong with Linux installations. | ||
+ | * In some Linux configurations, the .zip file will not automatically unzip. Instead, double-clicking on the .zip file simply opens a sort of archive manager that lets you look into the .zip archive as if it were a tree of ordinary files. You will not be able to run ZereneStacker in that environment. In that case you have to manually unzip the archive, using command line "unzip" or your favorite zip archive manager. \\ \\ | ||
+ | * Sometimes files do not retain their proper "execute" permissions after unzipping. In that case we suggest explicitly setting the required execute permissions using the following command line script: | ||
+ | <code> | ||
+ | chmod +x ZereneStacker/*.zslinux | ||
+ | chmod +x ZereneStacker/ZereneStacker.bsh | ||
+ | chmod +x ZereneStacker/ZereneStacker | ||
+ | chmod +x ZereneStacker/jre/bin/* | ||
+ | chmod +x ZereneStacker/jre/lib/jspawnhelper | ||
+ | </code> | ||
+ | * Be sure that you have downloaded the version of Zerene Stacker that matches your version of Linux. Attempting to run the 32-bit version of Zerene Stacker on a 64-bit Linux, or vice versa, may produce some confusing diagnostic like "cannot execute: required file not found", even though the ZereneStacker executable program is clearly present. | ||
+ | |||