Upgrading an existing site while upgrading the BlueZone emulator
As an option, you can also choose to perform a complete upgrade of your current Web-to-Host installation. We do not recommend
directly upgrading a BlueZone Web-to-Host site that is in production. It is preferable to copy the production files to a
new folder for testing and then, after upgrading and testing are complete, changing the virtual directory on the web server
to the new folder.
Note
This procedure assumes that the existing Web-to-Host sites that you want to upgrade are located on a Microsoft platform and
the Web-to-Host Wizard version 5.1 or higher is being installed on the same server.
|
1. |
Install the BlueZone Web-to-Host Wizard version 5.1 or higher. When the installation is complete, a shortcut to launch the
Web-to-Host Wizard will be placed on the desktop. |
|
2. |
On the web server, navigate to the location of your existing BlueZone Web-to-Host installation. The default name of this
folder is usually bzw2h and is usually located in \inetpub\wwwroot\ on the web server. |
|
3. |
Using Windows Explorer, make a copy the existing site to be upgraded. For example, copy bzw2h to bzw2hcopy. |
|
4. |
Using the desktop shortcut, launch the new Web-to-Host Wizard. The Sites page will be displayed. The Sites list will be empty.
|
|
5. |
On the Sites page, click Create. A standard Windows file dialog opens.
|
|
6. |
Browse to the location of the copied site, select it, and click Open. You will be prompted to create the site.
|
|
7. |
Click OK. The site will be created and added to your Sites list.
|
|
8. |
Click Next to go to the Launch Folders page. |
|
9. |
On the Launch Folders page, you will see that all the launch pages from the copied site appear as launch folders.
Note The Web-to-Host Wizard version 5.1 and higher will also copy two folders called default and desktop from your previous installation. These launch folders are no longer needed and can be deleted.
|
|
10. |
Select a launch folder and click Next. All of the sessions for the selected launch folder will be displayed.
|
|
11. |
On the Sessions page, note the presence of the Overrides button. This button provides backward compatibility with previous versions of the Web-to-Host Wizard. There is no need to change any values in the Overrides dialog. You can continue to use the overrides feature just as you
did in the previous versions of the Web-to-Host Wizard.
|
|
12. |
Click Next two times to advance to the Test Launch Folders page where you can select and test each launch folder. |
|
13. |
If you are running the Web-to-Host Wizard on a Microsoft platform with IIS enabled, you can use the IIS web server or you
can use the built-in web server to do your testing.
Note If you attempt to enable the built-in web server and you receive the following message: Unable to start the Web server on the selected port. That port is in use. Please select another port or close the conflicting
application.
This occurs because there is a web server (probably your IIS web server) already running on port 80. The remedy is to pick
another port (like 8080) and try again.
|
|
14. |
To test the launch folder, click Test BlueZone. |
|
15. |
To test additional launch folders, select the desired folder form the folder listbox and click Test BlueZone. You can test all your launch folders from this page without having to go back and select each launch folder from the Launch
Folders page. |
Note
To upgrade multiple Web-to-Host sites, repeat the upgrade (create) process for each site. If any of your existing Web-to-Host
sites have duplicate names, you must rename them with unique names before importing them into the new Web-to-Host Wizard.