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
(Optional step) Create a directory (folder) for the product files and a subdirectory for the logging files. The CPINSTALL.BAT script will perform this step for you later.
MD C:\cp
MD C:\cp\log
Next step, the program product file to be downloaded is in ZIP compressed format (.zip).
Note that you can use your browser 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.
Download by clicking the program product from the website to the
default download directory
designated by your browser settings.
If you use 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.
If you select your browser to open the downloaded
file then the browser will unzip
the compressed zip file into its separate component files in a
temporary folder. At this point you can let the CPINSTALL script
take over the process for you.
If you chose 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.
Now go to START and select RUN. Use BROWSE to locate the
downloaded
.zip file, and then RUN it.
The Windows RUN program will unzip
the compressed zip file into its separate component files in a
temporary folder.
pserver.jar
NetRexxR.jar
pserver.bat
pserver.sampdata
pserver.readme
cplogo200.png
cpinstall.bat
You have to then copy each component file listed below to the C:\cp
product folder. OR click on the CPINSTALL.BAT and let it finish the creation of the folder and the component copying for you.
COPY filename.file_extension C:\cp\*.*
or
CPINSTALL pserver
Setting of PATH and CLASSPATH
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 VISTA/ XP 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\pserver.jar;C:\cp\NetRexxR.jar;
PATH=C:\cp\pserver.jar;C:\cp\NetRexxR.jar
The pserver.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. Should you desire to use some drive other than the "C:"
then you must make the appropriate
changes.
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 changing to the C:\cp product folder
CD C:\cp
And then by typing:
C:\cp\pserver sampdata START
at a C-prompt (C:\) in a Command Window.
Linux Installation
The program product file
to be downloaded is in compressed format (.tar.gz).
You can use your browser's download and uncompress functions, OR
you can perform the manual steps outlined later to uncompress the file.
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 optionally open
the compressed (.tar.gz)
file from the file download window. Or you may
decide to save the compressed file to your
hard drive.
If you select your browser to open the downloaded
file then the browser will decompress the file into its separate component files in a
temporary folder.
This is where the CPINSTALL script
take over the process for you.
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.
Use the BROWSE to locate the
downloaded
.tar.gz file, and then RUN it.
The browser de-archive function will uncompress
the file into its separate component files in a
temporary folder.
Now each component file must be copied to the /usr/local/cp
product folder. Click on the CPINSTALL and let it finish the creation of the folder and the component copying for you.
CPINSTALL pserver
Now you can skip the following detailed manual steps and go to the "Setting of PATH and CLASSPATH" below.
(***Optional manual steps if you chose not to use the CPINSTALL script**)
Perform these steps below from a Terminal Command Window.
Locate the file (pserver.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 pserver.tar.gz /usr/local/cp/
Unpack the components.
tar -zxvf pserver.tar.gz
There will be files installed into the product directory after the unpack operation:
pserver.jar
NetRexxR.jar
pserver
pserver.sampdata
pserver.readme
cplogo200.png
cpinstall
Setting up PATH and CLASSPATH global variables
Each
of the JAR (JAVA Archive) files must be named in your CLASSPATH
environment variable.
SET CLASSPATH=/usr/local/cp/pserver.jar:/usr/local/cp/NetRexxR.jar:$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:
SET PATH=/usr/local/cp/:$PATH
The pserver script 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 file pserver
is set readable and executable by all (555).
Using ROOT access issue the command:
chmod 555 pserver
or
chmod +x pserver
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 pserver pserver.sampdata START at a prompt ($) in a Terminal Window.
To hook up the PServer ICON to the GNOME Panel, follow these steps:
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:
PServer
3. Right click the Command line on the Panel and enter the following
command:
<install_directory>/cp
<install_directory>/pserver.data
where <install_directory> is the location of your PServer
installation.
( e.g.
/usr/local/cp/pserver
/usr/local/cp/pserver.data )
4. Click the icon button and type in the following as the icon's
location: <directory_name>/cplogo200.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 current and potential customers who have emailed their
questions
regarding use and installation, and the suggestions for changes and
enhancements.
Keep the comments coming...
[Return
to Index]
[Return to Cullen
Programming Home Page]
Copyright © Cullen Programming 1999, 2008
| This page was last modified on 2008.06.20 |