The procedure assumes that you have a pre-3.3 version of BlueZone Web-to-Host installed, and you want to manually upgrade
your installation to the current version and you do not want to convert over to the new Web-to-Host Wizard. Also, it assumes
that you are very familiar with your current BlueZone Web-to-Host installation and the operation of your web server.
Who should use this method
Some BlueZone Web-to-Host Customers have made extensive customization changes to their Web-to-Host installations. For example,
you may have made web page and file structure changes in order to incorporate BlueZone Web-to-Host into a portal website.
If this is the case, you can still upgrade to the current version by manually copying the necessary files from the current
BlueZone Web-to-Host CD-ROM or image, to the proper locations in your current BlueZone Web-to-Host structure.
Note
If you are going to be using any of the new BlueZone emulators that were introduced in BlueZone version 4.0, like ICL 7561,
Unisys T27, and Unisys UTS, we don't recommend manually upgrading your existing installation. However, it is still possible
to manually incorporate the new emulators into an existing BlueZone Web-to-Host installation. Please contact BlueZone Software
Customer Care for assistance.
Description
In early versions of 4.0, the BlueZone Web-to-Host folder in the BlueZone CD image, did not contain folders for the CAB files
and the Web-to-Host Control files, as in the past. In these versions these files are stored internally, and can only be accessed
after the Web-to-Host Wizard 4.0 is installed and at least one site is created.
In versions 4.1 and higher, we added a new folder called \manual-upgrade. You no longer have to install the Web-to-Host Wizard
if all you want to do is upgrade your current installation.
We highly recommend that you make a backup copy of your current BlueZone Web-to-Host installation before attempting the upgrade.
Now that you have direct access to the needed files located in the \manual-upgrade folder, you can easily copy these files
to a backup folder of your current installation.
Finally, you will edit your current distribution files and object tags to conform to version 5.0.
Note
This procedure covers the upgrading of all the BlueZone emulators that were available in BlueZone Web-to-Host version 3.2
and older. If for example, you only use BlueZone Mainframe Display and Printer, you only have to upgrade the files associated
with BlueZone Mainframe Display and Printer. You do not have to upgrade the files located in the
bz5250,
bzFTP, and
bzVT folders.
The upgrade procedure can be broken down into the following parts:
|
• |
Insert the BlueZone CD-ROM into your CD/DVD drive and explore its contents. |
|
• |
Locate the \BlueZone Web-to-Host folder and open it.
|
|
• |
Locate the \manual-upgrade folder and open it.
|
|
• |
Make a complete copy of your current BlueZone Web-to-Host installation by manually copying your current Web-to-Host files
to a new location on your web server. You are performing the upgrade on this backup version so that you are not upgrading
your current live production installation.
|
|
• |
From the \manual-upgrade folder, copy the new CAB files, control files, and miscellaneous files to the backup copy of your current Web-to-Host installation.
|
|
• |
Edit your distribution files with the new CAB file names.
|
|
• |
Edit your INI files with several new entries to support new features.
|
|
• |
Edit your object tags with the new version. |
Following this outline, you can test the backup copy of your Web-to-Host installation for proper operation before making the
copy available as your production installation.