Please read this carefully BEFORE installing the Easysoft JDBC-ODBC
Bridge.

These instructions show how to install the Easysoft JDBC-ODBC Bridge
on UNIX platforms.

** You should only install this software onto a machine that holds ODBC 
** drivers that you want to access over the JDBC-ODBC Bridge from other machines.

** If the ODBC data sources to which you would like to gain remote access
** from any platform resides on other platforms (such as Linux or Windows),
** please obtain and install the Easysoft JDBC-ODBC Bridge appropriate for 
** those platforms.

** If you wish to gain access to your ODBC Data sources via JDBC from
** applets, you can use the build in HTTP server to serve them.

** For production use it is recommended that you take the Easysoft JDBC-ODBC 
** Bridge Driver classes from  <install_path>easysoft/job/EJOB.jar and make
** them available via your own Webserver.

** If you are developing or deploying applications you can download
** the JDBC-ODBC Bridge Driver classes directly from the machine
** that runs the server. See the page
** 	http://<your machine>:<EJOB HTTP PORT>/

If you have ODBC drivers on this machine (e.g. Easysoft's Tetra/CS3 or
Zortec ODBC drivers) which you want to access over the JDBC-ODBC
Bridge from other machines you should install the server. You must be 
root to install the server properly as it requires write access to 
/usr/local tree.

If you are installing the JOB Server to access ODBC drivers on this
machine from other machines via the JOB, then Easysoft recommends that 
you install the unixODBC Driver Manager.

PLEASE REMOVE ANY OLD INSTALLATION TREE BEFORE reinstalling or
installing a new version in the same tree. See the file 
<install_path>/easysoft//job/doc/uninstall.txt for instructions on 
how to do this.

On successful installation you are asked to point your browser at

    http://localhost:8031/

which provides the entry point to the installed documentation and demo pages.

If the installation had failed you can view these file from a browser with

    netscape file:///usr/local/easysoft/job/index.html

or visit the JOB website:
   
     http://easysoft.com/products/job/


Requirements
============

The installation script has a minimal set of requirements:

o Bourne shell in /bin/sh (if your Bourne shell is not located there you
  may need to edit the first line of the install file).

o Various commonly used UNIX commands such as:

  grep, awk, test, cut, ps, sed, cat, wc, uname, tr, find, echo, sum, head

  If you are missing any of these commands they can generally be
  obtained from the Free Software Foundation.

o Depending on the platform, you will need up to 5Mb of disk space
  free for the installed programs and up to 4Mb temporary space of the
  installation files themselves. If you install the unixODBC Driver Manager
  as well, these numbers increase by approximately 1.5Mb.

The installation process
========================

Untar the tar distribution file. On some platforms this is gzipped or
compressed. This should create a directory called
"jdbc-odbc-bridge-p.q.r.s.os" (where p.q.r.s is the version and os is
the operating system name) containing some further tar files, some
checksum files, this INSTALL file and an installation script
("install").


NOTE: Make sure you read the license agreement (Server-Client-License.txt). 
Installing the software shows your acceptance of the terms and conditions 
in the license agreement.

Throughout the installation you may be asked to supply the answer to
some questions. In each case the default will be displayed in square
brackets and you need only press <return> to take the default.  If
there are alternative responses these will be shown in round brackets;
to pick one of these type them and press <return>.

Change into the created directory and run the install program with
./install.

You will be prompted to read the license file appropriate for your
installation and you must answer yes or no to accept the license.  If
you do not accept the license, then the installation will be aborted.

Once the installation has checked you have the necessary shell tools
it will autodetect the operating system and check any required
dependencies (e.g. version of the C runtime library). Next the install
checks the encapsulated tar package(s) by comparing them with a
checksum file (do not worry if the md5 checksum is not found as some
platforms do not come with md5sum). If this fails you will be given
the opportunity to abort the installation.

You will next be prompted for an installation path. All files are
installed in a subdirectory of your specified path called "easysoft"
e.g. if you pick the default of /usr/local, the JOB will be installed
in /usr/local/easysoft and below. Some files outside the installation path
will be modified (but not without prompting you first).

If you choose an install path different from the default then the
installation will try to symbolically link /usr/local/easysoft to the
easysoft in your chosen path. This allows us to distribute binaries
with built in dynamic linker run paths. If you are not root or the
path /usr/local/easysoft already exists and is not a symbolic link
this will fail and you may have to fix the link yourself or define 
LD_LIBRARY_PATH/LD_RUN_PATH to contain the path <install_path>/easysoft/lib.
You should set LD_LIBARY_PATH/LD_RUN_PATH in the 
<install_path>/easysoft/job/startjob script.

The JOB is now distributed as 3 or 4 packaged tar files. These tar
files  are for common elements, the Java Applet demo, EJOB.jar JDBC Driver,
and  the server.  The tar files are all untarred into
subdirectories of <install_path>/easysoft.  You can consult
<install_path>/easysoft/job/INVENTORY.txt for a description of all the
files installed.

If the distribution for your platform contains the unixODBC driver
manager you will now be asked whether you would like to install
it. Please read the notes in the installation prior to this question 
because you do not have to install unixODBC.

Generally speaking, you should consider installing unixODBC if:

[1] You intend using multiple ODBC drivers under the JOB Server, i.e.
    you have multiple ODBC drivers on the machine you are installing
    on which you would like to access via the JOB.
[2] If your ODBC Driver is not ODBC 3.

If you choose to install unixODBC, its files will be untarred into <install_path>/easysoft/unixODBC.

The installation will next untar the common tar file. Some files and
shared objects are common to multiple Easysoft products. If files
shared between Easysoft products are included in the JOB install the
installation will check to see if those files already exist or are
older. Only if these files do not exist or are older will the shared
files be installed. You may see messages like:

versioned shared file <filename> does not exist - installing

or

versioned shared file <file> is old - replacing

The remainder of the installation installs the JOB server and requires
the installer to be the root user. If you are not root the
installation will terminate now.

The JOB Server requires a license in order to accept JDBC connections
from the JOB driver. There are currently three types of license.
Trial licenses last approximately one month and allow unlimited
connections from JOB clients but they expire one month after a license
is obtained. Full licenses (available for purchase) are available with
a 3 concurrent connection limit or unlimited concurrent connections.
The installation will create the <install_path>/easysoft/license directory if
it does not exist and also a licenses template file in that directory.
You can obtain a trial license or register a full license
automatically during the installation. When prompted to request an JOB
Server license, enter 'y' and the Easysoft License Client program will
be started for you.

To obtain a license automatically you will need to be connected to the
Internet and allow outgoing connections to ai.easysoft.com on port
8884.  If you are not connected to the Internet or do not allow
outgoing connections on port 8884 then the License Client can create a
license request file which you can mail, fax or telephone to Easysoft.

Once the License Client has started you are presented with a menu of
options which allow you to [0] exit, [1] view existing license [2]
show product list or [n] obtain a license for the desired
product. Obviously, if you have not got any other Easysoft products
licensed then option [1] will not show any existing licenses. To
obtain a license select one of the options from [2] onwards for the
product you are installing, e.g. currently, option [3] for licencing
the JDBC-ODBC Bridge. The License Client will then run a program that
was installed for that product which generates a key which is used to
identify the product and operating system (we need this key to license
you). NOTE, some products in the list may not be licensable during
the install, e.g. if you are installing the JOB and do not have the
Easysoft ODBC-ODBC Bridge installed then you cannot obtain a license
for the ODBC-ODBC Bridge (in this case the License Client will
probably output a warning that the siteinfo command for the chosen
product was not found). Assuming you have picked a product which is
installed (or in the process of being installed) then you need to
supply:

[a] Your full name
[b] Your company name
[c] An email contact address (you need to specify this if you email the
    license request to us).
[d] Your telephone number (you need to specify this if you telephone
    the license request to us).
[e] Your fax number (you need to specify this if you fax the license
    request to us).
[f] A reference number. When applying for a trial license just hit
   <return> on this field as this field is used to enter a reference
   number we will supply you for full (paid) licenses.

You will then be asked for a method of obtaining the license where the
choices are:

[1] Automatically by contacting the Easysoft License Daemon
    (this requires connection to the Internet and the ability to support
     an outgoing TCPIP connection to ai.easysoft.com on port 8884).
[2] Write information to file so you can fax, telephone it
    (the license request is output to license_request.txt and you can
     telephone or fax this to Easysoft).
[3] Cancel request

If you choose to obtain the license automatically, the License Client
will start a TCPIP connection to ai.easysoft.com on port 8884 and send
the details you entered at the prompts above and your site number.  No
other data is sent. The data sent is transmitted as plain text so if
you do not want this information possibly intercepted by someone else
on the net you should choose [2] and telephone or fax the request to
us.  The License daemon will return the license key, print it to the
screen and make it available to the installation script in the file
licenses.out.

If you choose option [2] the license request is written to the file
license_request.txt and you should exit the License Client via option
[0] and complete the installation. Once you have mailed, faxed or
telephoned the license request to us we will return a license key
which should add to the end of the file
<install_path>/easysoft/license/licenses.

If during this process any warnings or errors are output please mail
the output to support@easysoft.com and we will rectify the problem.

If you ran the License Client (above) the install script will detect
whether any licenses were automatically obtained and ask you if they
are to be installed in the <install_path>easysoft/license/licenses
file. You should answer y to this or the OOB Server will not be
licensed and will not accept connections from OOB clients. If you
choose not to have the licenses added to the licenses file then you
can do this manually later by copying the lines in licenses.out to
<install_path>/easysoft/license/licenses.

NOTE: The shared objects installed are NOT stripped. You may strip them if
you wish but this may affect any support Easysoft can supply.

Starting the JOB server
=======================

Start up the server by 

# cd <INSTALL PATH>/easysoft/job

and then run 

# ./startjob 

It should respond by saying that:
 
"Starting HTTP Server

The port is set to 8031 in this installation."

You can then use your Web browser for further on-line information at:

http://<your machine>:8031/

To go directly to a demo use:

http://<your machine>:8031/demo/


Stopping the JOB server
=======================

To stop the job server, ensure that you are logged in as the root user, 
then use the following script:

# ./stopjob

Response with 'y' to kill the processes shown. 


End of file












