note: DO NOT USE: The following UNIX starters are not suitable because of JRE install and configuration not being easy for ordinary users in the JRE "LUNIXstartSideWinderColourBalancer.jar" (PACKAGE DOWNLOAD file: LUNIXstartSideWinderColourBalancer(STARTER-LUNIX-jar).zip)
This version has been compiled in 1.5.0_03 Linux Sun Java SDK to allow use on machines that do not see much update. While updating over internet and is a perfectly normal idea to some, it is often where viruses come from and also in this country(Australia) not particularly well serviced unless the persons bank account is well serviced.Contrary to appearance i do not use Netbeans IDE much or to write this, i use gedit,Kwrite or notepad or contex or Netbeans as required for convenience. I also compile on the command line(unix or win) in a custom application structure so putting it into an IDE is useless except the bare source file for an IDE(I prefer to know what i am doing! e.g. custom tags,JSF,JSP,http web services WSDL e.t.c.) not rely on what someone can do quickly for me - e.g. "starters .bin and unistd.h with execlp or execvp" (Debian and Suse did not have "gcc" or "g++" bundled so i had to fall back on Slackware 10.1 and with both Win and Debian i can only start Slackware with the disk using "bare.i root=/dev/hda5 noinitrd ro" because grub and Lilo are not compatible at install time at overwriting each other)which i must say had a better chance here against java LinuxStarterMotor than anything else in linux and is why it is not included in this version download for UNIX's, however the most sensible is shell scripting for the modern OS's.
The easiest way to install it is to place it in the directory you want , that will be in your user directory or a sub-folder of that.
A user directory is the name of the user you log into your Linux system with. While "root" is a user, root user is only required if you need to change the permissions of the file so the sub rank user can use them, paticularly if you need to install an application.
Some Distros(flavours) of Linux do not have a direct "root" user you can log in as so you must use either the "super user terminal(command line)" or use the "super user file-browser(GUI visual mouse inter face)" to change the permissions.
You may need to allow the user to "execute" the file, so you potentially need to become the "root" user to "chown" the permissions of the executable file in a terminal or superuser file browser.
When the executable JRE installer is in the folder you want it (example here /home/nicephotog/Downloads ), open your terminal ,
then issue the command alike mine here, "cd /home/nicephotog/Downloads" (note the space between CD and the path) to set the terminal "current directory in use" (the one you want to install to and execute the JRE installer in)
Then simply write"./" followed on that line with no spaces the file name of the executable e.g. "./java_ee_sdk-6u2-jdk-linux-ml.sh" or "./jdk-1_5_0_03-linux-i586.bin"
You then you see text of the "license agreement" for your JRE or JDK or SDK. You must continue to press enter-key untill you are given the choice "i agree [yes no]"
Type onto the prompt "yes" if you agree to the license terms and after press "enter".
The installer will unpack into the directory the .bin or .sh executable installer is in.
But we are not done ... read next...
You must now enter super user mode and open /etc/profile Linux system configuration file
THIS IS DANGEROUS BUT EASY - SO BE CAREFUL!!!
Open it with either gedit or Kwrite text editor(any basic utility text tool editor is ok but you must be in super user mode)
Now go to the last line and put these("these" are my folder paths YOUR FOLDER PATHS IN YOUR MACHINE ARE WHAT YOU PLACE INTO /etc/profile) command lines (NOTE: the first is really for JDK and SDK)
export JAVA_HOME= /home/nicephotog/Downloads/jdk-1_5_0_03
export java=/home/nicephotog/Downloads/jdk-1_5_0_03/bin/java
export jar=/home/nicephotog/Downloads/jdk-1_5_0_03/bin/jar
finally , save the file , logout , and restart.NOTE: $PATH variable is a little more complex and another difficult but not too dangerous part of the top of /etc/profile lines that should be altered but not required here. Find a "Linux environment variables Tutorial".
When you finnish editing /etc/profile , save and exit the editor then logout and restart your machine.
Open the file called "startsidewinder.sh" and you will see this next line (is for larger computers - RAM -Xms256m -Xmx512m)...
or on a small computer(for smaller devices - RAM -Xms128m -Xmx256m) , but you may experience minor problems above 8 mega-pixel size images
REPLACE THIS "/home/nicephotog/EBLA2LX/origin-SRC-EBLA2/SideWinderColourBalancer/engine" WITH WHERE YOU PUT THE APP. ALL THE WAY INTO THE APP.
WITH THE ENGINE FOLDER "/your/complete/path/to/the/application/folder/engine"
AND THIS "/home/nicephotog/Downloads/jdk1.6.0_22/bin/java" , THE FULL PATH TO THE "java" EXECUTABLE (IMPORTANT - Linux is alike any unix system, the names of files and folders are letter case sensitive)
You must use the full path to the "java" executable to be used, and the full path to and with the "/engine" folder, this is because of a small glitch in some linux versions in determining the classpath at runtime inside the program and because a suitable startermotor has not been built because of such a problem somewhere!!!
To run Sidewinder, be sure to check on your "file properties menu"(right-click on the file in the GUI) that the "startsidewinder.sh" script is set as executable and all users can execute it.
Then simply click or double click on the script file startsidewinder.sh and it should run.
To run sidewinder you only need to change the lines of the script as previously told but also only need a JRE installed(install decompressed from the JRE's installer "ready to be configured", however it is good practice and helpful to other java applications to configure the JRE into the OS system files apart that being the right action to commit.)
For Mac users and other UNIX distributions not Linux, to Hazard a guess, change in the startsidewinder.sh, the shebang line (the first and top line of the shell script), from #!/bin/bash to #!/bin/sh also. However i do not know the /etc/profile system in those OS's or the login shells default or otherwise in use.You possibly require to write extra information using "chsh" command in the shell script. Other UNIX OS's than Linux will also require an installed JRE or JDK or SDK.
Make a Desktop convenience starter link
If you want to put a link to the startsidewinder.sh in Linux on your desktop for convenience, all you need to do is drag the startsidewinder.sh script icon from the /SideWinderColourBalancer/ folder and release it over the Desktop area and popup menu appears asking if you want to link the script file to the Desktop folder, select and press on "link to here" selection of the menu.
Here is an excerpt of the lines near the top in a Linux /etc/profile
notice that PATH does not have the $ sign with it, it is only used "when the script wants to use the contents of the variable".
notice there are two lines with similar information in the double quotes, and each "path" in there are separated by a colon : symbol.
on the end of both lines inside the double quotes put the full path to the /bin folder of the JRE or SDK/JDK with a colon on the left but not on the end
if [ "`id -u`" -eq 0 ]; then
PATH="/usr/lib/distcc/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
else
PATH="/usr/lib/distcc/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games"
fi
export PATH
redone, appears as example below
if [ "`id -u`" -eq 0 ]; then
PATH="/usr/lib/distcc/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/home/nicephotog/Downloads/jdk-1_5_0_03/bin"
else
PATH="/usr/lib/distcc/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games:/home/nicephotog/Downloads/jdk-1_5_0_03/bin"
fi
export PATH
OR you could put between the "if fi" this...
if [ "`id -u`" -eq 0 ]; then
PATH="/usr/lib/distcc/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
else
PATH="/usr/lib/distcc/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games"
fi
PATH=$PATH.":/home/nicephotog/Downloads/jdk-1_5_0_03/bin"
export PATH