Manually upgrading Version 3.3 or earlier to Version 6.2

This procedure assumes the following:

BlueZone Web-to-Host Version 3.3 or earlier is installed
You want to manually upgrade your installation to version 6.2
You do not want to convert to the new Web-to-Host Wizard
You are familiar with your current BlueZone Web-to-Host installation and the operation of your web server

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 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, for example, Unisys T27 or Unisys UTS, it is not recommend to manually upgrade your existing installation. However, it is still possible to manually incorporate the new emulators into an existing BlueZone Web-to-Host installation. Contact Technical Support for assistance.

Prior to Version 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. In previous versions, these files were stored internally and could 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 later, the \manual-upgrade folder was added. You no longer have to install the Web-to-Host Wizard if all you want to do is upgrade your current installation.

Now that you have direct access to the necessary files located in the \manual-upgrade folder, you can easily copy these files to a backup folder of your current installation.

Note: This procedure covers the upgrading of all of the BlueZone emulators that were available in BlueZone Web-to-Host Version 3.2 and earlier. 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 that are located in the bz5250, bzFTP, and bzVT folders.

Procedure

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.
Refer to Copying the existing Web-to-Host installation for more information.
Download the new BlueZone CD image.
Refer to Accessing the new files for more information.
Copy the new CAB files, control files, and miscellaneous files to the backup copy of your current Web-to-Host installation.
Refer to Copying the new Web-to-Host files to your current installation for more information.
Edit the distribution files with the new CAB file names.
Refer to Editing the distribution files for more information.
Edit the .ini files with several new entries to support new features.
Refer to Editing the default.ini file for more information.
Edit the object tags to include the new version.
Refer to Editing the object tags for more information.
Test the backup copy of your Web-to-Host installation for proper operation before making the copy available as your production installation.