Client Install
DataView may be obtained in 3 different formats:
- Download packages listed in download.html
- Download the dataview client but use a version of Java that is already on your machine
- Install from a CD that contains all the required files
The CD version is currently not offered online because it contains encryption
software that may be subject to US export restrictions. You can make up your own
CD for distribution to your employees or group.
Installing dataview-x.x.x-jre.tar.gz (Linux 32 bit)
- Copy dataview-x.x.x-jre.tar.gz to your /home/user directory and extract it:
tar xvfz dataview-version-jre.tar.gz
This will create a dataview directory and subdirectories inside it.
Read the readme.txt file in the dataview directory.
- From the install directory type
./install.sh and read the
Sun License Agreement using the scroll bar to move to the bottom. Then type
yes to accept it and continue.
- DataView should start for the first time using the extracted JRE.
- From the dataview directory you can type ./dv.sh to start DataView
- If you downloaded optional files for encryption or JDBC see
Installing optional files below
Installing dataview-x.x.x-jre-win.zip (Windows 32 bit)
I logged in as Administrator because the install script installs a JRE in
C:\Program Files\Java and I don't know if a regular user has that permission.
- Copy the zip file to a directory. I used "My Documents"
- Right clicked on the zip file and extract all files to the suggested
folder or one you decide to use. This should create a dataview directory.
- Move to the dataview directory and Left click on install.bat
- This will install the Sun JRE 1.5. Select Yes to accept the license
and accept the default setup.
- Now the bat file will copy some jar files to the JRE and run dataview
for the first time. It may take a several seconds to finish this process.
- DataView should open and write a new config file.
Installing dataview-version-naked.tar.gz with a downloaded JRE
- Copy dataview-version-naked.tar.gz to your /home/user directory and extract it:
tar xvfz dataview-version.tar.gz
This will create a dataview and subdirectories inside it.
-
Extract the JRE (Java Runtime Environment) file you downloaded from Sun.
./jre-1_5_X-linux-i586.bin (where x is the minor update)
This will create a directory called jre1.5.x.
Move or copy the entire directory to dataview and rename it jre.
-
Move or copy
dataview/lib/dataview-version.jar to dataview/jre/lib/ext
dataview/lib/xercesImp.jar to dataview/jre/lib/ext
- From the dataview directory you can type ./dv.sh to start DataView
- If you downloaded optional files for encryption or JDBC see
Installing optional files below
Installing dataview-version-naked.tar.gz with local version of Java (for experts)
The current version of dataview-x.jar is compiled with J2SE jdk-1.5.x.
If you have a J2SE 5 (aka jdk1.5) or JRE 1.5 on your system and you know about
classpaths and envrionmental variables this may work for you.
- Perform step 1 above to create a DataView install directory.
- Put any jar files you require in
dataview/lib (not jre/lib/ext)
- Move to the dataview directory and examine the script
dv-with-java.sh
Make sure the script has execute permission and the classpaths look correct.
- Start dataview using
./dv-with-java.sh
- To enable encryption and local database connections you will have to copy
the policy files and jar files to the JRE located in the external version of Java.
Installing optional files
-
Extract the policy file from Sun
unzip jce_policy-1_5_X.zip
This will create a directory called jce.
Copy the files from the jce directory to dataview/jre/lib/security.
-
Move or copy the jar file from Bouncy Castle
bcprov-jdk15-126.jar to dataview/jre/lib/ext
-
If you downloaded a the optional mysql connector
Copy mysql-connector-x-bin.jar to dataview/jre/lib/ext
See the docs/advanced-localdb for instructions
on creating a connection.
Linux CD version
A CD version should contain all the classes and jar files required to run DataView
and do encyption. Check for a readme.txt or readme-windows.txt file in your dataview
directory once you extract the .tar.gz or .zip file.
Sample data
Try opening one of the sample tables from the File menu. There is an install doc
in your new dataview directory that lists login information for a guest account
on a DataView server. You can connect to the server from the Remote-Catalog
menu annd find a list of tables to download. More will appear as time goes on.
|