Host Access Solutions: Terminal Emulation Software and Host Integration

QuickStart Instructions for PASSPORT WEB TO HOST® 2007 with Microsoft IIS

1. Check your system requirements

Before installing PASSPORT WEB TO HOST, make sure that your web server meets the following system requirements. If these requirements are not met, you may have unpredictable results.

• TCP/IP connection to the host
• Windows 2008/2003/2000 server with IIS installed (with the latest service pack applied)
• Microsoft .NET Framework 2.0 or higher installed
• ASP and ASP.NET installed and enabled

2. Installing PASSPORT WEB TO HOST®

It is strongly recommended that you exit all Windows programs before running the Windows Installer Package. PASSPORT requires about 20 MB of disk space.

• To begin the installation, double click on the downloaded MSI package or insert the CD, the setup program will start upon inserting the CD. If Autorun is disabled on your PC, double-click on the MSI file to begin.
• Enter the license code in the required field. This code is given to you by Zephyr at downloading time or on the sleeve of your CD. You must have a valid license code in order to proceed with the installation. Note: If a license code was emailed to you from Zephyr, it is recommended that you copy and paste it into the License Code field to avoid typing errors. You may leave the license code blank to install a 30-day trial version.
• Choose the web site and name for the virtual directories to use. If you only have one web site installed on your IIS server, select "1" for the web site. If you have multiple web sites running on your IIS server, you must enter the appropriate number for the web site. The default virtual directory for launching a PASSPORT WEB TO HOST session (Client web site) is pec and the default virtual directory for the administrator program (Administrator web site) is pecadmin.
  
  http://YourWebSite/pec/ is the web site your users will connect to when launching a PASSPORT WEB TO HOST session.
  
  http://YourWebSite/pecadmin/ is the web site you will connect to when running the PASSPORT Administrator program.
• Choose the directory where you would like to install PASSPORT. If you wish to change the installation directory, click the Browse button, which will allow you to select another directory. Note: If the Setup program detects a previously installed version of PASSPORT, it will prompt you to overwrite your existing installation. If the same version is detected, you will be prompted to remove or repair the application.
  
  C:\Program Files\PASSPORT eClient Admin\ is the default folder where PASSPORT is installed.
• Click Next to begin the installation.

3. Configure the PASSPORT WEB TO HOST® file types (for Windows 2003 running IIS 6 ONLY)

Start the Internet Information Services (IIS) Management Console.

• Right-click the web site where the PASSPORT virtual directories (pec and pecadmin) are located and choose Properties from the pop-up menu.
• Select the HTTP Headers tab, then click the Mime Types button to display the Mime Types dialog box.
• Click the New button, then enter the following:
  
  Extension: zwm
  Mime Type: application/octet-stream
• Repeat the previous step and enter the following:
  
  Extension: zwh
  Mime Type: application/octet-stream
• Click OK to save, then OK again to close the website Properties page.
• Select the Web Service Extensions folder to display the list of available extensions.
• Right-click Active Server Pages, and then choose Allow from the pop-up menu.

4. Start the PASSPORT WEB TO HOST Administrator web site

Start Internet Explorer and type in the URL http://YourWebSite/pecadmin or use the Start->Programs->PASSPORT WEB TO HOST Admin->Administrator. This starts PASSPORT Administrator Web site. There are four sections: Configure, Deploy, Support and Documentation. Each section provides pertinent information to help you quickly complete the installation and configuration.

5. Start the PASSPORT WEB TO HOST Administrator configuration program

• Click on the Configure icon at the top of the administrator web site. This link opens up another Internet Explorer window with the administration configuration program running inside it. The first time you click on this icon an ActiveX component will be downloaded and expanded. The following message appears: Security Warning - Do you want to install and run PASSPORT WEB TO HOST signed and distributed by Zephyr Corporation. This is the PASSPORT digital signature obtained from VeriSign Commercial Software Publishers. The purpose of the digital signature is to ensure the software is valid and has not been tampered with or corrupted during the download process.
  
  Note: If you are running Windows XP SP2, you might also be alerted by the Information Bar to allow the downloading and installing of the ActiveX control before making a successful connection. The message appears as: The previous site might require the following ActiveX control: 'PASSPORT WEB TO HOST for Internet Explorer' from Zephyr Development Corporation'. Click here to install...
• The first time you start the administrator configuration program you will be prompted to fill in the system administrator information and you have the option to set a password. This is an important security measure as it ensures that only authorized administrator(s) can make changes to the PASSPORT environment.

6. Create a session profile

In the left pane, do the following:

• Expand 3270 Display by clicking the "+" symbol to the left.
• Highlight Sessions.
• Click the right mouse button to bring up the pop-up floating menu.
• Select New.
• The Add New Session Profile dialog box appears.
• Enter a name for the new session profile and press the OK button.
• The Session Profile property sheet appears.
• Enter a description for the new session profile, if desired.
• Enter the Host Name or IP Address.
• Enter any other necessary connection information.
  
  Note: If you're required to establish a secure socket layer connection to your host then check the option Enable Secure Connection on this screen. In order for the SSL connection to take place, both the client and the server must have SSL configured. Check with your host administrator for more information.  If you're having a connection problem with an SSL session on Windows Vista, please review the Troubleshooting Tips section for more information.
• Click OK.

7. Create a User (optional)

In the left pane, do the following:

• Highlight Users.
• Click the right mouse button to bring up the pop-up floating menu.
• Select New.
• The New User dialog box appears.
• Enter a user name (UserID) and description.
• Click on the 3270 Display tab.
• Highlight the session name that was created previously.
• Click the Add button to add the session to the list of assigned display sessions.
• Click OK.

8. Test the session profile from the server

In the right pane, do the following:

• Highlight the name of the session profile you just created.
• Click the right mouse button to bring up the pop-up floating menu.
• Select Connect.
• A new Internet Explorer window is opened and the selected session profile will be launched.

If PASSPORT WEB TO HOST fails to load or if the mainframe screen does not appear, follow the troubleshooting tips details below.

9. Launch the session profile from a client PC

Before launching a PASSPORT WEB TO HOST session profile, the client PC must meet the following system requirements. If these requirements are not met, you may have unpredictable results.

• Windows Vista, XP, or Windows 2000 (with the latest service pack applied)
• Internet Explorer version 6.0 or higher
• TCP/IP connection to the web server
• TCP/IP connection to the host

To launch a PASSPORT WEB TO HOST session:

• To start the desired session profile access the following URL: http://YourWebServer/pec/
• PASSPORT launch page is displayed and you are prompted for a user name or session name. Enter the user name or session name created previously and click the Submit button.
• If you’ve entered a user name, a browser window appears containing the list of available sessions for this user.
• Click on the session name you want to start. The first time you run a PASSPORT WEB TO HOST session from a client PC, the ActiveX components are downloaded to the client PC and expanded. The following message appears: Security Warning - Do you want to install and run PASSPORT WEB TO HOST signed and distributed by Zephyr Corporation. This is the PASSPORT digital signature obtained from VeriSign Commercial Software Publishers. The purpose of the digital signature is to ensure the software is valid and has not been tampered with or corrupted during the download process.
  
  Note: If you are running Windows XP SP2, you might also be alerted by the Information Bar to allow the downloading and installing of the ActiveX control before making a successful connection. The message appears as: The previous site might require the following ActiveX control: 'PASSPORT WEB TO HOST for Internet Explorer' from Zephyr Development Corporation'. Click here to install...
• Press the YES button to continue.
• If PASSPORT WEB TO HOST fails to load or if the host screen does not appear, follow the troubleshooting tips details below.

You are now ready to use PASSPORT WEB TO HOST

10. Troubleshooting Tips

Remember: If you need to talk to Zephyr Technical Support about your connection problem, you will have to completely fill out the support request form from our web site and obtain your INCIDENT ID number.

• If you cannot launch a session, or if the text data of the Ecomes.zwh file is displayed in your browser window, you will need to follow the troubleshooting instructions displayed in the browser. If this occurs, it is generally caused by the security setting on the browser or a firewall that is preventing the downloading or execution of ActiveX components.
• If you are able to launch a session ( Tip: If PASSPORT WEB TO HOST has been successfully loaded and is running, the PASSPORT menus are merged with the IE menus and the PASSPORT toolbar and button bars appear) but do not get a host connection, you should get an error message generated by PASSPORT. When receiving the error, you can find solutions in the following places:
  
  
  • Our knowledgebase under the Support section on our web site
  • Our documentation under the Error Messages in the Troubleshooting section
    
• Sometimes, the host may not handle error processing correctly or may not handle it at all. In these instances, you may not get an error message. To resolve your connection issue, you will have to:
  
  
  • Click the Communication->Connection Log menu command to view the connection log. The connection log displays the Telnet negotiation commands sent between PASSPORT and the host system. This can be used to determine why the connection failed.
  • Search our knowledgebase under the Support section on our web site. Many of the common connection problems are reported here.
    Search our documentation for common connection problems.
    
• If you still cannot get a connection, the last alternative is to run a Low Level Trace and email it to Zephyr Technical Support for analysis. To expedite your request, you will need to completely fill out a support request form on our web site under the Support section.
  
  Note: see Running a Trace in our documentation for instructions on how to do this.

If you cannot get a PASSPORT SSL session to connect from a Windows Vista PC, it is possible that your host is only configured to use the DES cipher suite for secure connection. By default, Windows Vista disables this feature for security purposes. You will need to either re-configure SSL on your host to use a different cipher suite, or follow the steps below to enable the DES cipher suite on your Windows Vista PC to allow PASSPORT to work:

1. Go to Start Menu, and type gpedit.msc in the Start Search and press <ENTER>. There might be an UAC elevation prompt. Just allow the action and proceed with the next step.
2. Under Computer Configuration in Group Policy Object Editor, expand Administrative Templates, expand Network, expand SSL Configuration Settings, and then double-click SSL Cipher Suite Order.
3. Select Enable and append TLS_RSA_WITH_DES_CBC_SHA,SSL_RSA_WITH_DES_CBC_SHA, at the beginning of the pre-populated string value. (Beware of the ending comma and there should not be any embedded space inside the string).
4. Click OK and restart your computer. (Note: gpupdate command will update the Group Policy settings but reconfiguration of SChannel.dll requires restart.)