Cullen Programming

 Program Product Installation

If you have not yet downloaded and installed the FREE SunMicrosystems J2SE JAVA Run Environment (J2 Standard Edition JRE) then please go to the Download page for instructions. Then return here.

For users new to the JAVA Run Environment please see our JRE Setup Help page.

Windows Installation
The program product file to be downloaded is in compressed format (.zip). 

You can let your browser perform the download and unzip (uncompress) functions,  OR you can use PKZIP, WinZip, the XP Unzip Wizard or most other free zip utilities to uncompress the zip file.  We recommend using the browser.

Note:  Please substitute any occurences where you see  <product_name> for the actual name of the program product, such as "jscan".

By clicking the program product from the website will cause a  download to the default download directory designated by your browser settings.

If you use Google Chrome, Internet Explorer, or Firefox, or Safari you can optionally open the compressed (.zip) file from the file download window.  Or you may decide to save the compressed file to your hard drive. 

Then your browser will ask you if you wish to extract files.   Perform the Extract all files operation from the File pulldown. 

The extraction program will recover from the compressed zip file into its separate component files in a temporary folder.

<product_name>.jar
NetRexxR.jar
<product_name>.bat
cpreadme
cplogo64.ico
cpinstall.bat
<product_name>install.bat

At this point you can select the install script to take over the process for you. 

Double-click the <product_name>install.bat script (ie. jscaninstall.bat).  A product folder will be created if not already present, the product components will be moved into it, and a shortcut icon will appear on your desktop.

If you choose your browser to save the downloaded file then the compressed program product will be placed in its original compressed form into the designated download folder.  Follow the  manual procedure below. 

(***Optional Manual Procedure if you choose not to use the install script**)
Perform these steps below from a  Command Window.

Locate the compressed file (<product_name>.zip) that you just downloaded from our website.

Create a folder for the product files and a subdirectory for the logging files.  Then copy the compressed file that you downloaded to the product folder, lastly change directory to the product folder.

md  C:\cp
md  C:\cp\log  
copy  <product_name>.zip   C:\cp\*.*
cd  C:\cp

Unpack the components.

unzip  <product_name>.zip

There will be files installed into the product directory after the unpack operation:

<product_name>.jar
NetRexxR.jar
<product_name>.bat
cpreadme
cplogo64.ico
cpinstall.bat
<product_name>install.bat

From your RUN Window execute

<product_name>install.bat
Example:  for the product PSERVER run the following:
pserverinstall.bat

Setting of Windows PATH and CLASSPATH global variables

Now so that your operating system can easily find the product files we recommend that you update the PATH and CLASSPATH global system variables.  Under Windows the system variables can be updated by going to:

START-->CONTROL  PANEL-->SYSTEM-->ADVANCED-->SYSTEM VARIABLES. 

Select the PATH and CLASSPATH named system variables and build (or modify) the pathname concatenation list by appending to the end of the list.

Each of the JAR (JAVA Archive) files must appear in your CLASSPATH and PATH environment variables.  Example of pathname concatenation list:

CLASSPATH=%CLASSPATH%;C:\cp\ <product_name>.jar;C:\cp\NetRexxR.jar;
PATH=%PATH%;C:\cp\ <product_name>.jar;C:\cp\NetRexxR.jar

The <product_name>.bat script will set both of these variables temporarily for you.


The batch files and configuration file assume that you are installing the execution components on your C-drive and running from the C:\cp directory. 

Make sure that you uncomment the log directory entry for Windows in the configuration file, and comment out the Linux entry for the log directory.

You can perform an initial test start by clicking the CP ICON or by changing to the C:\cp product folder

CD  C:\cp

And then by typing:

C:\cp\ <product_name>  <parameters, if any>

at a C-prompt (C:\) in a Command Window.

Linux Installation
You must have ROOT privileges to successfully run this procedure.

The program product file to be downloaded is in compressed format (.tar.gz).  
You will use your browser's download and uncompress functions.

Note:  Please substitute all occurences of  <product_name> for the actual name of the program product, such as "jscan".

Download by clicking the program product from the website to the default download directory designated by your browser settings.

If you use Netscape or Firefox you can open with Archive Manager on the compressed (.tar.gz) file from the file download window.
(Or you may decide to save the compressed file to your hard drive).  

Now hit the window icon to Extract files. 

Select All Files in the Extraction window.   And direct it to a temporary folder,  (such as /home/youruserid/temp).

Then click the extract icon from the archive window.  This will un-archive the .tar file into its separate file components.  They will appear in the temp folder window that you so directed.

At this point you can select  the install script to take over the process for you.

Double-Click on the <product_name>installicon from the temp folder window.  It wil create the target product folder, copy the product components and create an icon on the Desktop.

If you directed your browser to save the downloaded file then the compressed program product will be placed in its original compressed form into the designated download folder.   Follow the manual procedure below.

(***Optional Manual Procedure if you chose not to use the install script**)

Perform these steps below from a Terminal Command Window.
Locate the file (<product_name>.tar.gz) that you downloaded from our website.
Acquire privileged "root" access. 

Create a directory (folder) for the product files and a subdirectory for the logging files.  Then copy the compressed file that you downloaded to the product folder.

mkdir  /usr/local/cp
mkdir  /usr/local/cp/log
chmod 666  /usr/local/cp/log            (the 666 designates read and write permitted)
cp  <product_name>.tar.gz  /usr/local/cp/

Unpack the components.

tar -zxvf <product_name>.tar.gz

There following files will be installed into the product directory after the unpack operation:

<product_name>.jar
NetRexxR.jar
<product_name>
cpreadme
cplogo6.png
cpinstall
<product_name>install

Setting up LINUX PATH and CLASSPATH global variables

Each of the JAR (JAVA Archive) files must be named in your CLASSPATH environment variable. 

CLASSPATH=/usr/local/cp/ <product_name>.jar:/usr/local/cp/NetRexxR.jar:$CLASSPATH
EXPORT  $CLASSPATH

So that the operating system can find the product files, the installation directory must be named in the PATH environmental variable.  An example of the pathname concatenation:

PATH=/usr/local/cp/:$PATH
EXPORT  $PATH

The invoking script file will do set both of these variables temporarily for you.

Make sure that you uncomment the log directory entry for Linux in the Product Configuration File, and comment out the Windows entry for the log directory.

Ensure that script files are set readable and executable by all  (555 or 755).
Using ROOT access issue the command:

chmod 555 *
or
chmod +x  *

Make sure that you uncomment the log directory entry for Linux in the configuration file, and comment out the Windows entry for the log directory.

You can perform an initial test start by typing:

<product_name>  <parameters, if any>

 at a prompt ($) in a Terminal Window.

Optional Manual procedure to establish the CP Logo ICON to the GNOME Panel

1. Click the GNOME Main Menu button, open the Panel menu, and then open the Add to Panel sub-menu and choose Launcher.

2. Right click the Name line on the Panel and enter:    <product_name>

3. Right click the Command line on the Panel and enter the following command:

    <install_directory>/cp  <install_directory>/<parameters>

where <install_directory> is the location of your product installation.

( e.g. /usr/local/cp/<product_name>  /usr/local/cp/<file data parameters> )


4. Click the icon button and type in the following as the icon's location:  /usr/local/cp/cplogo6.png

Follow the Users Guide on this website for additional setup and use information.

Please email us if you are having any difficulties or have questions on it's setup or use.

Thank you to all who have emailed their questions regarding use and installation, and the suggestions for change and enhancements.

We look forward to your comments.