Differences

This shows you the differences between two versions of the page.

--- stacker:docs:linux_installation_instructions [2013/04/06 21:01]
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 ======
-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>
   ZereneStacker            top level directory
-      ZereneStacker.bsh      launch script
+      ZereneStacker          executable launcher
+      ZereneStacker.bsh      launch script (provided for backward compatibility)
+      zerenstk.ini           launch template, expanded by the launcher based on user configuration settings
       ZereneStacker.jar      jar containing the application
       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)
 </code>
+The executable launcher, ZereneStacker, is written so that it can be accessed in any manner, including by symbolic link or being placed on the PATH.  If you want to use a JRE other than the one provided with the distribution, just edit the zerenstk.ini template as desired.
 The launch script ZereneStacker.bsh is written so that the package will run no matter where it is placed.  You can launch it from the desktop or a file browser by double-clicking it and confirming either "Run" or "Run in Terminal".  Alternatively, you can execute it from a Terminal window as ZereneStacker/ZereneStacker.bsh (plus whatever path prefix is required to find the ZereneStacker directory).
 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.