Installation

BlueZone Web-to-Host

Other Web Servers

Introduction

If you want to install BlueZone Web-to-Host on a web server that is not listed, follow this general procedure.

BlueZone Web-to-Host installation is fairly simple.  It's a matter of copying the BlueZone Web-to-Host files from the BlueZone CD to your web server, being careful to maintain the directory structure exactly as it appears on the BlueZone CD.  If you are very familiar with configuring and accessing HTML pages from your web sever, you should have little to no problem if you follow this procedure.

We recommend using a Windows workstation and BlueZone FTP to FTP the BlueZone Web-to-Host files to your web server.  Your web server will have to be running an FTP server in order for this method to work.  You can use any FTP client that you may already have installed and are familiar with.

If you can browse to your web server using a program like Samba, that will work also.

Procedure
Step 1 - Upload the BlueZone Web-to-Host Files to the Web Server

  1. Install BlueZone FTP (located on the BlueZone CD) on your Windows workstation or if you can browse to your web server from a Windows workstation using a utility like Samba, that will be fine.

  2. Configure BlueZone FTP to connect to your web server (or connect to it using Samba).

  3. Locate the BlueZone Web-to-Host folder on the BlueZone CD.

  4. For your convenience, we have provided .tar and .gz files which contain the entire contents of the BlueZone Web-to-Host folder.

These files are called bzw2h.tar and bzw2h.tar.gz

  1. FTP or copy the .tar or .gz file to your web server to a temporary location.

To expand the .gz file type:

gzip -c -d bzw2h.tar.gz | tar xvf -
 

To expand the .tar file type:

tar -xvf bzw2h.tar
 

  1. Create a "bluezone" directory in the "root" (publishing directory) of your web server, or if you prefer, you can name it anything you wish.

  2. Move or copy the expanded directories and files into the “bluezone” directory.

  3. Upload the SEAGULL Activation File (seagull.saf) you received from your Seagull Software Account Manager or Seagull Software Order Administration, as BINARY and replace the existing seagull.saf file.  The SAF file contains license information and is required for the BlueZone session to run once it is downloaded to the browser.

NOTE  If you don't have a Seagull Activation File, or you don't know what a Seagull Activation File is, you can skip this step and continue with the installation.  You can install the SAF file at a later time. Click here for help in obtaining and manually installing a SAF file.

Step 2 - Configure the Web Server

  1. Set file permissions to "read" ("write" is not necessary) and "execute scripts" (running executables is not necessary) and directory browsing is not necessary.

NOTE  For UNIX and Linux servers, assuming that you copied all the BlueZone Web-to-Host files to a directory called "bluezone", then issuing the command "chmod 755 bluezone" should set the proper file permissions for the BlueZone directory.  Also, make sure that all the files located below the BlueZone directory inherit these same file permissions.

Step 3 - Testing the Installation

  1. From a Windows workstation, launch your browser.

  2. Type in the URL of your web server, followed by /bluezone (or whatever you called the folder where BlueZone Web-to-Host is installed).

Example: http://63.69.143.23/bluezone  or  http://www.myhost.com/bluezone

If your web server is set up properly, the default.htm page will launch.  To see a non-working example of the default.htm page click here.

  1. Click the Default Web-to-Host Download link.  The Web-to-Host Control Module will download and install.  Then, a web page with a BlueZone Launch Pad will be displayed.  The Launch Pad will contain one of each of the BlueZone emulation clients.

  2. Launch a BlueZone session of your choice by double clicking on any of the icons.  Since the default configuration file does not contain any host connection information, the session will launch, but will not connect to a host.

TIP  If you want to connect to a UNIX or Linux host use BlueZone VT.

  1. To test your host connection, select Session:Configure from the BlueZone MenuBar.  The Define New Connection dialog will be displayed.

  2. Give the connection a name, then fill in Host Address and TCP Port.  Click the OK button.

  3. Click the OK button one more time to close the dialog.

  4. From the MenuBar, select Session:Connect.  Your session should now be connected to your host.

  5. To save the session, select File:Save from the MenuBar.

  6. If you have both Internet Explorer users and Netscape users, be sure to test with both browsers.

NOTE  When conducting browser tests, it’s okay to run IE and Netscape at the same time however, you can not launch a BlueZone display session from one browser then launch the same BlueZone display session from the other.  The second session will not launch.  You must close down the first BlueZone session (not the browser) before launching the same BlueZone session with the other browser.

Congratulations!  You have successfully installed and tested BlueZone-Web-to-Host.

Next Steps:

How to Install the Web-to-Host Wizard for Local Publishing