|
|
JET 6530 Documentation > Upgrading
Upgrading
Introduction
Here are instructions on how to upgrade JET 6530,
that is how to install a new version of JET 6530 if you
already have an older version installed.
If you need to revert to an older version of JET 6530 these
upgrade instructions will not work. You must
remove the older version,
which includes removing the JET 6530 class files from each
client machine, then install.
Warning: Upgrading from JET 6530 2.6 or earlier
The JET 6530 3.0 user interface and configuration
methods are new and improved.
Please note before installing JET 6530 3.0 or later that the
applet parameters and configuration files are not
compatible with those from version 2.6 or earlier.
The JET 6530 3.x class files will not work as expected
with HTML pages designed for version 2.6 and user's saved preferences
and host list files created by version 2.6.
If you use a customised web page you must change it. See
Configuration for
information on creating a web page to load JET 6530 3.x.
Upgrading JET 6530 on your workstation
If you installed an older version or demonstration copy of
JET 6530 on your workstation, follow these steps to upgrade it.
- For a Windows 98, Me, NT, 2000 or XP system:
- Open Windows Explorer.
- Find the JET 6530 installation directory. The default
is "C:\jet6530" for JET 6530 versions 3.1 and
earlier and is "C:\Program Files\JET 6530" for
versions 3.2 and later.
- Copy any customised web pages you created to a temporary
directory.
- Delete the installation directory and its contents.
- Download the JET 6530 self-extracting archive,
jet6530.exe, to your disk
- Note that licence details prior to version 3.2A are not
compatible with versions 3.2A and onwards, and vice
versa. Your current licence details are automatically
included in your JET 6530 download. You can also
obtain your current licence details from the Customer
Services section of the Platypus Partners web
site.
- Run the self-extracting archive, jet6530.exe,
by double clicking it.
- Follow the on screen instructions
- If you have customised web pages follow the instructions
below for updating them.
- For a Unix/Linux system:
- Find the installation directory you untarred the JET
6530 archive into.
- Copy any customised web pages you created to a temporary
directory.
- Delete the contents of the installation directory.
- Download the JET 6530 tarred archive,
jet6530.tar, or tarred and gzipped archive,
jet6530.tar.gz.
- Note that licence details prior to version 3.2A are not
compatible with versions 3.2A and onwards, and vice
versa. Your current licence details are automatically
included in your JET 6530 download. You can also
obtain your current licence details from the Customer
Services section of the Platypus Partners web
site.
- Copy the archive into the installation directory.
- From your favourite shell, gunzip the archive, if required,
using the command:
gunzip jet6530.tar.gz
Untar it using the command:
tar -xvf jet6530.tar
- If you have customised web pages follow the instructions
below for updating them.
- For a Mac OS X system:
- Find the JET 6530 installation folder. Usually this
is "jet6530 Folder" on the Desktop.
- Copy any customised web pages you created to a temporary
folder.
- Move the installation folder to the Trash.
- Download the JET 6530 zip archive,
jet6530.zip.
- Usually the zip archive will automatically be unpacked to
create a new "jet6530 Folder" on the desktop. If not use
Stuffit Expander to unpack the archive.
- Your current licence details are automatically
included in your JET 6530 download. You can also
obtain your current licence details from the Customer
Services section of the Platypus Partners web
site.
- If you have customised web pages follow the instructions
below for updating them.
Upgrading JET 6530 on your web server
If you installed an older version of
JET 6530 on your web server, follow these steps to upgrade it.
- Download one of the JET 6530 archives to your
workstation.
- Expand the archive into a temporary directory on your
workstation.
- Transfer the following files from the applet directory to the
web server:
- JET6530Key.jlk (Your licence key file)
- JET6530.cab (distribution unit for Internet
Explorer)
- JET6530SU.jar (SmartUpdate JAR file for
Communicator)
- JET6530E.jar (JAR file for Communicator,
Netscape 6 and Mac OS X)
- updateJET6530.js (JavaScript source for
Communicator)
- bell.au (audio file)
- jet164.jpg (JET logo image file)
These are binary files, except for updateJET6530.js,
so set the binary option if your file
transfer package supports it.
- If you are not using a customised web page to load JET 6530,
transfer the Shortcut.htm file from the applet directory to the
web server.
- If you want users to view the JET 6530 documentation,
transfer all of the document directory to the web server.
- Delete from the web server any files from the old JET
6530 version still present. Files that have not just
been transferred (see above) and are not your customised web
pages or your image files are probably from the old JET
6530 version. If you are upgrading from JET 6530
2.6 or earlier delete the "images" directory and its contents. If
upgrading from 3.3 or earlier delete the "JET3270J.jar" file.
- If you have customised web pages follow the instructions
below for updating them.
- Copy the customised web pages to the appropriate directory,
renaming them to avoid overwriting files from the archive.
- Warning: If you are upgrading from JET
6530 2.6 or earlier the new class files will not work
as expected with your customised web pages. You must change your
web pages. See
Configuration for further
information.
- Update the distribution unit version in your web pages with
the value for the new version:
Find the distribution unit version of the new version at
the start of the Release Notes ("Release Notes.txt" in the
installation directory). It is four numbers separated by
commas. Find the "useslibraryversion" applet parameter in your
web pages. It looks something like this:
<PARAM NAME="useslibraryversion" VALUE="2,6,2,32767">
The value depends on which version of JET 6530 you
are upgrading from. The applet parameter may be generated
by a JavaScript writeln statement, particularly if your
web page is based on the Shortcut.htm file. If your web page
does not contain a "useslibraryversion" applet parameter,
maybe because you are upgrading from a version of JET
6530 that did not use distribution units, you must
update it for distribution units. See
Configuration and the
Shortcut.htm and Sample*.html files for further
information.
Change the value of the "useslibraryversion" applet parameter
to the version for the new version.
Ensure your web pages are using the SmartUpdate package
version number for the new version or not using SmartUpdate:
Check that your web pages either (a) use the
updateJETIfRequired function from the
new version of the updateJET6530.js
JavaScript source file; or (b) do not use
SmartUpdate.
A web page using the function from
updateJET6530.js will have lines like this:
<SCRIPT LANGUAGE="JavaScript" SRC="updateJET6530.js">
</SCRIPT>
to load the script and a line like this:
if (updateJETIfRequired("JET6530SU.jar"))
to check the version of any installed JET 6530
class files and initiate downloading and installation of
the new class files if required. The updateJET6530.js
file from the new version of JET 6530 has the
SmartUpdate package version number for that version in it.
A web page that does not use SmartUpdate has the attribute:
ARCHIVE=JET6530E.jar
in the APPLET tag and does not call updateJETIfRequired or
ConditionalSoftwareUpdate.
See Configuration
for more information on creating a web page to use
SmartUpdate.
If your web pages use SmartUpdate but do not use the
updateJET6530.js file installed, change the
version number your JavaScript is checking for to the
SmartUpdate package number for the new version, which can
be found at the start of the Release Notes. The details
of the change depend on your JavaScript.
Upgrading JET 6530 class files
Once you have upgraded JET 6530 on your workstation or
web server, your JET 6530 users should follow these steps
to install the new class files on their local file system and
use the new version.
Communicator with built-in Netscape virtual machine
- Quit Communicator.
- Start Communicator.
- Open the web page used to load JET 6530. This may be
the Shortcut.htm file or a customised web page on your workstation
or a web server.
- A dialog box titled "SmartUpdate: Downloading Install" will
appear. If you are loading JET 6530 from your workstation
it may disappear before you see it. If you are loading JET
6530 from a web server over a slow network connection
it may take several minutes for the SmartUpdate JAR file to be
downloaded.
- A dialog box saying installation of JET 6530 is complete
will appear. Click "OK".
- Quit Communicator.
- Restart Communicator.
- Open the web page used to load JET 6530.
- The new version of JET 6530 will run.
Internet Explorer with Microsoft VM under Windows
- Close all Internet Explorer windows. If the Active
Desktop feature of Internet Explorer is installed then
restart your computer.
- Start Internet Explorer.
- Open the web page used to load JET 6530. This may be
the Shortcut.htm file or a customised web page on your workstation
or a web server. If you are loading JET 6530 from a
web server over a slow network connection it may take several
minutes for the distribution unit cabinet archive to be
downloaded.
- A Security Warning dialog box asking if you want to install and
run the new version of JET 6530 will appear. Click "Yes".
- The new version of JET 6530 will run.
Troubleshooting
If your users have problems upgrading the class files see
Working with
installed class files for troubleshooting information.
|
