|
|
JET 3270 Documentation > Upgrading
Upgrading
Introduction
Here are instructions on how to upgrade JET 3270,
that is how to install a new version of JET 3270 if you
already have an older version installed.
If you need to revert to an older version of JET 3270 these
upgrade instructions will not work. You must
remove the older version,
which includes removing the JET 3270 class files from each
client machine, then install.
Warning: Upgrading from JET 3270 2.6 or earlier
The JET 3270 3.0 user interface and configuration
methods are new and improved.
Please note before installing JET 3270 3.0 or later that the
applet parameters and configuration files are not
compatible with those from version 2.6 or earlier.
The JET 3270 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 3270 3.x.
Upgrading JET 3270 on your workstation
If you installed an older version or demonstration copy of
JET 3270 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 3270 installation directory. The default
is "C:\jet3270" for JET 3270 versions 3.1 and
earlier and is "C:\Program Files\JET 3270" 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 3270 self-extracting archive,
jet3270.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 3270 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, jet3270.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
3270 archive into.
- Copy any customised web pages you created to a temporary
directory.
- Delete the contents of the installation directory.
- Download the JET 3270 tarred archive,
jet3270.tar, or tarred and gzipped archive,
jet3270.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 3270 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 jet3270.tar.gz
Untar it using the command:
tar -xvf jet3270.tar
- If you have customised web pages follow the instructions
below for updating them.
- For a Mac OS X system:
- Find the JET 3270 installation folder. Usually this
is "jet3270 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 3270 zip archive,
jet3270.zip.
- Usually the zip archive will automatically be unpacked to
create a new "jet3270 Folder" on the desktop. If not use
Stuffit Expander to unpack the archive.
- Your current licence details are automatically
included in your JET 3270 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 3270 on your web server
If you installed an older version of
JET 3270 on your web server, follow these steps to upgrade it.
- Download one of the JET 3270 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:
- JET3270Key.jlk (Your licence key file)
- JET3270.cab (distribution unit for Internet
Explorer)
- JET3270SU.jar (SmartUpdate JAR file for
Communicator)
- JET3270E.jar (JAR file for Communicator,
Netscape 6 and Mac OS X)
- updateJET3270.js (JavaScript source for
Communicator)
- bell.au (audio file)
- jet164.jpg (JET logo image file)
These are binary files, except for updateJET3270.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 3270,
transfer the Shortcut.htm file from the applet directory to the
web server.
- If you want users to view the JET 3270 documentation,
transfer all of the document directory to the web server.
- Delete from the web server any files from the old JET
3270 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
3270 version. If you are upgrading from JET 3270
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
3270 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 3270 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
3270 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 updateJET3270.js
JavaScript source file; or (b) do not use
SmartUpdate.
A web page using the function from
updateJET3270.js will have lines like this:
<SCRIPT LANGUAGE="JavaScript" SRC="updateJET3270.js">
</SCRIPT>
to load the script and a line like this:
if (updateJETIfRequired("JET3270SU.jar"))
to check the version of any installed JET 3270
class files and initiate downloading and installation of
the new class files if required. The updateJET3270.js
file from the new version of JET 3270 has the
SmartUpdate package version number for that version in it.
A web page that does not use SmartUpdate has the attribute:
ARCHIVE=JET3270E.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
updateJET3270.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 3270 class files
Once you have upgraded JET 3270 on your workstation or
web server, your JET 3270 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 3270. 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 3270 from your workstation
it may disappear before you see it. If you are loading JET
3270 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 3270 is complete
will appear. Click "OK".
- Quit Communicator.
- Restart Communicator.
- Open the web page used to load JET 3270.
- The new version of JET 3270 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 3270. This may be
the Shortcut.htm file or a customised web page on your workstation
or a web server. If you are loading JET 3270 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 3270 will appear. Click "Yes".
- The new version of JET 3270 will run.
Troubleshooting
If your users have problems upgrading the class files see
Working with
installed class files for troubleshooting information.
|
