nicephotog-jsp.net back to home link

sidewinder logo

Whats here for Linux

Screenshots,
About the application in Linux ,
How to install java to your Linux machine ,
How To install and configure the JRE
How To install and run the application.
final JRE configuration with $PATH variable

WARNING: DO NOT TRY TO START THE APPLICATION UNTIL YOU CONFIGURED AND EDITED THE PATHS IN "startsidewinder.sh" (easy enough, they are only 2 paths folder and file)

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)

DOWNLOAD - Compiled in Oracle - Sun Microsystems Java2 1.5.0_03 on Debian Linux OS tested in both JRE 1.5.0_03 and JRE 1.6.0_22 on Debian Linux and Slackware 10.1 Linux

repackaged: Sat, Apr 28, 2012 with help documentation added

LINUX-EBLA2-C17-2-j6-22

Link: Download (1.04 MB) SidewinderPhotoColourBalancer here for LINUX repackaged: Sat, Apr 28, 2012 with help documentation added

Like i said i thought i compiled it in 1.5.0_03(wasn't 1.6.0_22) Anyhow, who gives a stiff sh... it operates properly.

*1*** News of hand in testing again reveals it may have been failing because of running the editor without the RAM assignment in the command line(that works with the RAM assignment in the command, and the machine has at least 1Gb of RAM) ..."-Xms256m -Xmx512m"... this last piece, so its more than probably a false alarm. It did write the correct Raster version updated this time so it was probably machine specific(it was a 12 mega pixel image test too).

AND AGAIN: NOTE! That RAM assignment is compulsory in the application startup command because while the JVM knows how much RAM to assign for the bare program, there can be at least four copies of the "variable user data"(up to around 256 Mega-bytes or more of "the image") the JVM cannot judge would be there in truest potential of quantity.

DOWNLOAD - MS-Win compiled 1.5.0_02 for Linux only

Link: Download (1.04 MB) SidewinderPhotoColourBalancer here for Linux (Windows compiled 1.5.0_03 that operates in Linux)

*Link: Download : SideWinder How To Use - Helpfile

*Link: Download : (PDF) linux-userguide-all.pdf (Illustrated GUI desktop user guide for Linux)

*Link: "chmod" and "chown" file permission command

*Link: Understanding and changing file permission in Linux

Link: (PDF) Debian Linux system and OS user guide (a typical Linux distribution)

Link: Basic Linux Install information

Link: Linux Filesystem (e.g. "ext3" or "ext4" are their normal base type others are for show and special usage)

NOTE: Large pictures in use by the Hue board above 6 - 8 megapixel can take thirty seconds to complete, press "apply" button once only, and wait until the "Hue Board" disappears.

Get the Java JRE Runtime

Link: Download : Get the JRE for Java: Win, Solaris, Linux

Link: Download : Get the JRE for Java: Mac

Screenshots of EBLA2-C17 2 SidewinderPhotoColourBalancer

These are in Debian OS flavour, one of its latest releases.

Screenshot1

Screenshot2

Screenshot3

About the version in Linux

First, this is the same as the windows version except the Win. files are not included to assist install and configuration simplicity.

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.

How to Install the Java JRE

Any Java JRE 1.5.0_03 or newer is suitable to run this application.
First you should have downloaded either a .bin or .sh file called SOMETHING LIKE(only)" java_ee_sdk-6u2-jdk-linux-ml.sh" or "jdk-1_5_0_03-linux-i586.bin" BUT should not have SDK or JDK in the name if your simply a java application user, it should have JRE in its name.

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...

How to configure your JRE to operate in Linux

Your JRE needs to be recognised automatically to start java applications and applets! by issuing the command "java" on the terminal command line or by .sh shell scripts

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

NEXT ALSO if you have a JDK or SDK for java but if you can find the folder path in the JRE it is worth also puting into /etc/profile

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.

How to run the EBLA2-C17 2 application

Put the Sidewinder application folder into a folder in your user directory by dragging and dropping it from the "ark" or some other archiver GUI interface. (note: you only need to have a JRE installed not configured into the OS system files and edit the paths below mentioned, in the commandline in "startsidewinder.sh" to operates the application)

Open the file called "startsidewinder.sh" and you will see this next line (is for larger computers - RAM -Xms256m -Xmx512m)...

/home/nicephotog/Downloads/jdk1.6.0_22/bin/java -classpath "/home/nicephotog/EBLA2LX/origin-SRC-EBLA2/SideWinderColourBalancer/engine" -Xms256m -Xmx512m SidewinderPhotoColourBalancer

or on a small computer(for smaller devices - RAM -Xms128m -Xmx256m) , but you may experience minor problems above 8 mega-pixel size images

/home/nicephotog/Downloads/jdk1.6.0_22/bin/java -classpath "/home/nicephotog/EBLA2LX/origin-SRC-EBLA2/SideWinderColourBalancer/engine" -Xms128m -Xmx256m SidewinderPhotoColourBalancer

REPLACE THESE FOLLOWING PARTS OF THE LINE (NOTE - THE COMMAND LINES IN THIS DOCUMENT AND THEIR FOLDER PATHS ARE ONLY AN EXAMPLE AS A GUIDE!!!)

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.

$PATH if you want to set it(which you really should but be careful)

Here is an extract of near the top of the /etc/profile Linux configuration logon startup script

# /etc/profile: system-wide .profile file for the Bourne shell (sh(1))
# and Bourne compatible shells (bash(1), ksh(1), ash(1), ...).

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