1 Installing Java Virtual Folders
Below is a description on how to install Java Virtual Folders on a UNIX
operating system, followed by a description on how to install the folders on a
Windows NT operating system.
INSTALLING UNDER UNIX
Java Virtual Folders for UNIX is installed as follows:
- The package file names depend on the platform used, and whether native
(nat) threads or green (grn) threads are used. Examples,
where xxx means nat or grn, are as follows:
- For a Linux platform: hwjvfxxx.tgz
- For a Hewlett and Packard platform:hwjvfHxxx.tgz
- For a Sun platform the options are: hwjvfSUNxxx.tgz
Note: For more information on the packages see
the Readme file
- Copy the Java Virtual Folders package for your architecture to the
directory where you want to install Java Virtual Folders, e.g. your home
directory. If you are a system administrator you can install Java Virtual
Folders globally in a directory such as /usr/local.
- Unpack the Java Virtual Folders package. For example, for Linux this is
done as follows:
gzip -dc hwjvfLINnat.tgz|tar xvf -
This will create a directory called HWJVirtualFolders/.
- Add the HWJVirtualFolders/jvf script to your path. This is done
by extending the path environment variable with the HWJVirtualFolders/
directory.
e.g. setenv path=(~/HWJVirtualFolders $path)
Or by linking the script to a directory which is currently in the path.
e.g. cd /usr/local/bin
ln -s /usr/local/HWJVirtualFolder/jvf
The first time you start Java Virtual Folders, a directory called
.hwjava is created in the user's home directory. This directory is
used to store the various configuration files.
Note: It is recommended to set the access rights of the
.hwjava directory to have read/write access only for the owner (e.g. cd; chmod
700 .hwjava).
INSTALLING UNDER WINDOWS NT
Java Virtual Folders for Windows NT is installed as follows:
- Double click on the package with the file name hwjvf.exe
- Wait while the Install Shield Wizard works automatically. The Hyperwave
Software License Agreement then appears. See Figure 1.
Figure 1: The Hyperwave Software License Agreement
- Read the license text carefully, then click on the Yes button to
accept the license agreement. The Hyperwave Setup dialog box appears. See
Figure 2 below.
Figure 2: Hyperwave Setup
- You can save the Virtual Folders files to the default destination
directory, or change the path by click on the browse button next to the default
path name. Choose your own destination from the list menu displayed in the
pop-up dialog box. Click on the OK button to process, or cancel to
return to the default destination.
- Click on the Next button in t he Hyperwave Setup dialog box; the
Java Virtual Folders will be installed on your computer. Wait while the files
are copied to your directory destination. See Figure 3.
Figure 3: Installing Hyperwave Java Virtual Folders
- A query dialog box appears which asks you if you wish to view the
Hyperwave Java Virtual Folder Readme file now. Depending on your choice, click
on the Yes or No button. If you click on Yes the Readme
file appears; X to close the Readme window.
- The next dialog box give you the option of rebooting you computer straight
away or later. Click the desired option, and click on the OK button. If
you wish to restart the computer immediately, make sure all other data is
saved.

Figure 4: Restarting Windows dialog box
- The final dialog box informs you the Hyperwave Java Virtual folders were
installed successfully; click on the OK button to close.
- You can find the installed files in the destination
directory.
Note: It is recommended to set the access
rights of the hwjava directory to have read/write access only for the owner
(e.g. cd; chmod 700 hwjava).