Contents TableOfContents
Installation
To start the 2.2a1 installation, please proceed as follows:
download the jython_Release_2_2alpha1.jar file and save it locally ([http://sourceforge.net/project/showfiles.php?group_id=12867 Download from sourceforge])
double-click the file jython_Release_2_2alpha1.jar, or type: java -jar jython_Release_2_2alpha1.jar
This will bring up the GUI installer ([http://homepage.sunrise.ch/mysunrise/ohumbel/install-22a1.html Screen shots]).
On true headless systems, the installer will automatically switch to console mode. You can force console mode using the -console switch:
java -jar jython_Release_2_2alpha1.jar -console
Generation of start scripts
On Windows, the installer creates a jython.bat and a jythonc.bat file. On all other platforms, it creates a jython and jythonc file, which are unix like shell scripts. If these scripts are not executable, please grant the permission on os system level.
Please let us know if you need different scripts on different platforms.
Troubleshooting
If one of the GUI steps should appear empty, or with no text visible: Please try to press Previous and then Next again.
The GUI which appears when pressing the Browse button in selecting the target directory might be a bit confusing. Some tips and tricks:
it uses the standard javax.swing.JFileChooser
- opening and selecting of a directory: there are different looks and feels on different platforms - just play a little to get used to yours
- the icon for creation of a new directory is sometimes greyed out, although java would have the rights to create one. If this happens, select the parent directory and then try to type in the name of the new directory in the input field. The installer then will create the new directory, if possible
If all else fails, try using console mode.
A sample console session
This is a transcript from a Windows XP machine, using MKS Korn Shell in Emacs. It doesn't look much different when using cmd.exe:
$ java -jar jython_Release_2_2alpha1.jar -console Welcome to Jython ! You are about to install Jython version Release_2_2alpha1. (at any time, answer c to cancel the installation) For the installation process, the following languages are available: English, German Please select your language [e/g] >>> e The following installation types are available: 1. All (everything, including sources) 2. Standard (core, library modules, demos and examples) 3. Minimum (core) Please select the installation type [1/2/3] >>> 1 Your operation system version is: Windows XP / 5.1 Please press Enter to proceed >>> Your java version is: Sun Microsystems Inc. / 1.5.0_06 Please press Enter to proceed >>> Do you want to read the license agreement now ? [y/n] >>> n Do you accept the license agreement ? [y/n] >>> y Please enter the target directory >>> c:/temp/jython2.2a1 Unable to find directory C:\Temp\jython2.2a1, create it ? [y/n] >>> y Please confirm copying of files to directory C:\Temp\jython2.2a1 [y/n] >>> y 10 % 20 % 30 % 40 % 50 % 60 % 70 % 80 % 90 % Generating start scripts ... 100 % Do you want to show the contents of README ? [y/n] >>> n Congratulations! You successfully installed Jython Release_2_2alpha1 to directory C:\Temp\jython2.2a1. $
What will be different on the HEAD version
- enables silent installation, without user interaction
- enables selection of a different java runtime for the start scripts
- start scripts are made executable by the installer
- better help and usage
A preview of the usage:
usage: java -jar jython_HEAD.jar [-s | -c] [-d dir] [-h | -?] [-t type] [-j dir] the following options are available: -? print this help/usage. -c,--console do a console based installation (with user interaction). -d,--directory <dir> target directory to install to; required if in silent mode; ignored if not in silent mode. -h,--help print this help/usage. -j,--jre <dir> home directory of the runtime jre, or jdk; executables are assumed in the /bin subdirectory; ignored if not in silent mode. -s,--silent do a silent installation (without user interaction). -t,--type <type> installation type: all, standard or minimum; ignored if not in silent mode. no option at all will start the interactive GUI installer. example of a GUI installation: java -jar jython_HEAD.jar example of a console installation: java -jar jython_HEAD.jar -c example of a silent installation: java -jar jython_HEAD.jar -s -d targetDirectory example of a silent installation with more options: java -jar jython_HEAD.jar -s -d targetDirectory -t minimum -j javaHome