travelport booking feed (tbf) · product has remained the same; therefore, travelport booking feed...

Travelport Booking Feed (TBF) Installation Guide

16 July 2012

16 July 2012 Travelport ii

THE INFORMATION CONTAINED IN THIS DOCUMENT IS CONFIDENTIAL AND PROPRIETARY TO TRAVELPORT.

Copyright

Copyright © 2006–2012 Travelport and/or its subsidiaries. All rights reserved.

Travelport provides this document for information purposes only and does not promise that the information contained in this document is accurate, current or complete. This document is subject to change without notice.. No part of this document may be reproduced, stored in a retrieval system, or transmitted in any form or any means electronic or mechanical, including photocopying and recording for any purpose other than the licensee’s personal use without the prior written permission of Travelport and/or its subsidiaries.

Trademarks

Travelport and/or its subsidiaries may have registered or unregistered patents or pending patent applications, trademarks copyright, or other intellectual property rights in respect of the subject matter of this document. The furnishing of this document does not confer any right or license to or in respect of these patents, trademarks, copyright, or other intellectual property rights.

All other companies and product names are trademarks or registered trademarks of their respective holders.

16 July 2012 Travelport iii

Contents

Introduction .................................................................................................................................... 1

Prerequisites .................................................................................................................................. 2

Hardware Prerequisites ............................................................................................................... 2

Recommended Hardware ........................................................................................................ 2

Minimum Hardware .................................................................................................................. 2

Software Prerequisites ................................................................................................................. 2

Operating System ..................................................................................................................... 2

Recommended Databases ....................................................................................................... 2

Reporting Software ................................................................................................................... 3

Connectivity .................................................................................................................................. 3

Connection Speed .................................................................................................................... 3

Queues ..................................................................................................................................... 3

Firewall Settings ....................................................................................................................... 4

Before You Begin........................................................................................................................... 5

Updating from Earlier Versions .................................................................................................... 5

Installing a SQL Server ................................................................................................................ 5

Installing and Configuring TBF .................................................................................................... 6

Installing TBF ............................................................................................................................... 7

Configuring the TBF Adapter ..................................................................................................... 13

Manually Installing/Updating the Client Database ..................................................................... 15

Setting Up the ODBC Connection ............................................................................................. 16

Setting Up the ODBC Connection in a 64-Bit Operating System ........................................... 16

Setting Up the ODBC Connection in a 32-bit Operating System ........................................... 17

Running the TBF Adapter ........................................................................................................... 22

Uninstalling the TBF Adapter ..................................................................................................... 23


16 July 2012 © Travelport 2006–2012. All Rights Reserved. 1

Introduction This installation supports release 2.08.02 of Travelport Booking Feed (TBF). Previously, this product was known as Galileo Integrated Data Source (GIDS or Galileo IDS). Versioning for this product has remained the same; therefore, Travelport Booking Feed 2.08.02 supersedes Galileo Integrated Data Source 2.07.

This Installation Guide supports installation for the following Travelport Booking Feed (TBF) components.

The TBF installation includes:

TBF 2.08.02 Adapter, including Java version 15.0_13.

This application serves as the interface between the Galileo® or Apollo® GDS system and the customer’s local database. The TBF Adapter:

1. Pulls agency information from the Apollo and/or Galileo queue.

2. Parses the data.

The currently supported databases are Microsoft® SQL Server® and Sybase® Adaptive Server®. For a list of recommended databases, including Adaptive Server and SQL Server, see “Software Prerequisites” on page 2.

Setup scripts are included for the client database for both Adaptive Server and SQL Server. These setup scripts can be installed with the adapter or manually installed, as preferred.

Note: Versions 2.05 and earlier of the TBF installation included a companion Nortel Contivity VPN installation for customers that did not already have the necessary connectivity to Galileo or Apollo. The Nortel installation is no longer included as part of the TBF installation. See “Connectivity” on page 2 for connectivity options with the current release of TBF.

See the following companion documents for more information about implementing TBF:

TBF Product Overview

TBF Data Definitions

Release Notes (included with the installation)



Prerequisites The following requirements should be confirmed before installing TBF.

Hardware Prerequisites The recommended/minimum hardware requirements to run TBF are:

Recommended Hardware

Intel® Pentium® 4 (or later) with 1 GB RAM

Note: The TBF installation is approximately 40 MB.

1 GB of hard disk space

CD-ROM drive

Minimum Hardware

Intel® Pentium Intel® 200 with 256 MB RAM

500 MB of hard disk space

CD-ROM drive

Note: The TBF Client Adapter can be configured to exclusively log XML data and bypass the client database for receiving data. In this implementation, the XML data logs must be manually deleted. Therefore, the hard drive must allow for enough space to capture the anticipated amount of logs accumulate between purges.

See “Host XML Logging” in the TBF Product Overview for details.

Software Prerequisites Each user is required to purchase and install the following software in support of TBF.

Operating System

Any version of Microsoft® Windows® or Microsoft Server® currently supported by Microsoft.

Recommended Databases

For customers who choose to use a database to receive TBF data, the following databases are recommended:

Microsoft® SQL Server®

Sybase® Adaptive Server®

Recent versions of both Microsoft SQL Server and Sybase Adaptive Server have worked successfully with TBF to date, although not all versions have been formally certified. Contact your representative if you encounter difficulties with using TBF in conjunction with a specific version of these products.



If you do not have either of these databases, you can download trial versions from www.microsoft.com or www.sybase.com.

Reporting Software

For customers who want to produce ready-made reports for management teams, it is recommended that an application, such as Crystal Reports, is used with the database.

Connectivity Internet connectivity is the standard method to access TBF. However, if a site currently has a direct IP subscriber line to Galileo or Apollo, or already has Extranet installed for an application, a VPN connection does not need to be installed.

Previous versions of the TBF installation included a companion Nortel® Contivity VPN installation for customers that did not already have the necessary connectivity to Galileo or Apollo. The Nortel installation is no longer included as part of the TBF installation.

The following connectivity options are supported with this version of TBF:

SSL connection (Recommended)

If SSL is being used for connectivity, customer must also have Port 443 open to gdssl-atl.galileo.com. Refer to the SSL Installation Guide for further details. A copy of the guide is available at http://support.galileo.com/aps.

Existing unmanaged VPN connection

Directly connected lease line

Contact your Travelport representative to discuss connectivity options suitable for your environment.

Connection Speed

A high-speed connection, such as DSL or Broadband, is required. A dialup connection is not supported, as even low-volume customers may experience difficulties such as backed up queues that lead to a potential loss of data.

Note: The TBF product is not a query/reply (synchronous) architecture whereby clients initiate a request and receive a real-time response. Instead, TBF uses a workflow (asynchronous) architecture in which data volume represents a combination of all available data for TBF-designated transactions at a given time. Therefore, an individual agency’s response time can be affected by the aggregate volume of transactions.

Queues

A Queue ID for each customer queue will be assigned by Travelport. Depending on the expected data load, more than one TBF queue may be required. See the TBF Product Overview to help determine the number of required queues.

Additional connectivity permissions may be required, depending on the type of connection.



Firewall Settings

If TBF is used through a direct connection, i.e., a leased line rather than a VPN connection, the following firewall settings must be adhered to:

If the market runs its own network, they must also ensure that they open Port 1415 on their firewall.

If SSL is being used for connectivity, customer must also have Port 443 open to gdssl-atl.galileo.com.

Refer to the SSL Installation Guide for further details. A copy of the guide is available at http://support.galileo.com/aps.



Before You Begin Before you begin installing Travelport Booking Feed/GIDS 2.08.02, the following tasks should be performed.

Updating from Earlier Versions Important! If you are updating from an earlier version of TBF, be sure to include these additional steps before installing TBF 2.08.02:

Make note of the current version of TBF/GIDS. You will be asked to provide this version during the installation process.

If you are unsure of your current version, click the support information link of Travelport Booking Feed in the Add or Remove Programs window in the Control Panel.

Back up all existing files and databases, including logs. While the database is not removed during installation, the installation will attempt to update it.

In addition, the TBF folder is deleted and all files in this folder should be backed up. By default, this folder is located in C:\Program Files\Galileo International\.

Record all configurations from the TBF Adapter Console (page 13), including the Queue Name and MQ Host Destinations.

If you are running TBF as a service the console data is available through the wrapper.log files. See the “Logging” section TBF Product Overview for details.

Uninstall the existing TBF application from your system. If you attempt to install TBF 2.08.02 over your existing version of TBF/GIDS, you will receive an error message, and be asked to uninstall your current version. See “Uninstalling the TBF Adapter” on page 23 for instructions.

Installing a SQL Server If you have not already installed a SQL database server (see “Software Prerequisites” on page 2), it is recommended that you install the server before installing or updating TBF 2.08.02. The TBF 2.08.02 installation includes an automatic installation for a Microsoft® SQL Server® database.

If you choose to install the database server after you install TBF 2.08.02, see “Manually Installing/Updating the Client Database” on page 15 for instructions.

Customers who choose to use a direct XML feed of TBF data do not need to install a database.

Galileo Integrated Data Source (GIDS) Installation Guide

10 January 2010 © Travelport 2006–2010. All Rights Reserved. 6

Installing and Configuring TBF The installation and configuration process for TBF varies depending on whether the installation is new or an upgrade, and on optional selections made during the installation.

Step Description Applies To Page

Installing TBF Installs the TBF 2.08.02 adapter. This installation also includes Java version 1.5.0_13.

All installations. 7

Configuring the TBF Adapter

Configures the settings on TBF 2.08.02 Adapter.


Setting Up the ODBC Connection

Allows the client database to communicate with the Galileo or Apollo data source.

New installations that do not receive a direct XML log feed.

Note: Updated installations should confirm that the ODBC connection is working properly.

15

Manually Installing/Updating the Client Database

Manually runs the database setup scripts to install/update modifications to the client database tables.

New or updated installations that have opted NOT to automatically install/update the client database. I.e., customers that select the Skip option on Step 12 of the installation (SQL Database Setup).

Note: This step applies only to customers who are implementing a database feed for TBF. Customers who are using a direct XML feed of TBF data do not need to install and configure the client database.

15

Running the TBF Adapter

Confirm that the Adapter is working properly.




Installing TBF The following instructions detail how to install:

The TBF Adapter, which includes Java version 1.5.0_13.

Setup scripts for the client database for both Sybase® Adaptive Server® and Microsoft® SQL Server®.

See the TBF Product Overview for more information about connectivity options and implementing TBF.

To install TBF:

1. From a Web browser, go to the TBF installation site. The URL for this site and initial installation instructions are provided by your Travelport representative.

After the application downloads, the Welcome window of the InstallShield Wizard displays.

2. Click Next to display the Customer Information dialog box.

3. Enter your User Name and Company Name for the TBF registration.



4. Click Next to display the Choose Destination Location dialog box.

5. Select an installation location for the TBF application:

Click Next to install TBF in the default location. By default, TBF is installed in C:\Program File\Galileo International\GIDS\, where C is the machine’s hard drive.

Note: To maintain backwards compatibility, TBF is retaining the same installation path that was used for previous versions of this product. As a result, existing GIDS/TBF customers will not need to modify scripts or other references for third-party applications that access TBF components.

OR

Click Browse to select another hard drive or server location for the installation.

6. After you choose the destination location, click Next to display the Start Copying Files window.



7. Click Next to start copying files. This process may take a few moments.

After the TBF application files are installed, the Application Shortcuts message displays.

8. Select your Application Shortcuts preference.

Click Yes to install a shortcut to the TBF Adapter on your desktop. OR

Click No to not install a shortcut on your desktop. A shortcut is always available from the Windows Start menu in All Programs > Travelport > Travelport Booking Feed 2.08.02.

9. After you select an Application Shortcuts option, the SQL Database Setup dialog box displays.

10. The SQL Database Setup programmatically builds or updates the TBF database for any locally installed version of Microsoft® SQL Server®. Select one of the following options depending on your installation status and intended database management:

If you are updating a previous TBF installation, select one of the following versions and click OK:

TBF (GIDS) v2.06 to 2.08.01

TBF (GIDS) v2.05

TBF (GIDS) 2.04 or earlier

If TBF was not previously installed on this system, select New Installation and click OK.



If you intend to manually build or update the database after installation, click Skip. This option should be used if:

Microsoft SQL Server has not been installed yet.

Using a non-local (remote) SQL server.

Using a PC that has multiple SQL server connections.

Using a SQL server that prompts for a logon.

Using a Sybase database.

You want to manually create the database.

See “Manually Installing/Updating the Client Database” on page 15 for more information about this option.

The InstallShield Wizard Complete window displays.

11. Click Finish to complete the installation and display the TBF Adapter service message.

After the installation is complete, the service message displays.

Customers have the option to run the TBF Adapter as a service:

Click No to not install the TBF Adapter as a service.

OR

Click Yes to install the TBF Adapter as a service into the Windows service panel. The service automatically starts the next time the machine is rebooted.

Note: When the Client Adapter runs as a service, the Adapter Console is not available. However, the output data is available as a log. See the “Data Flow” section of the TBF Product Overview for more details.



When run as a service, the Services list displays Travelport Booking Feed Adapter.

If you selected Yes, the following message displays.

Click OK to confirm the installation of the TBF adapter as a service.

12. The TBF Application Properties dialog box automatically displays after installation. The Queue Name is required; all other modifications to the default settings are optional.

13. Click Apply on the TBF Application Properties dialog box to display the Release Notes message.

14. It is recommended to click Yes to view the release notes.



15. Shortcuts

After installation, the following shortcuts are installed, if the shortcuts option was selected. By default, these shortcuts are installed on the Windows Desktop:

The TBF 2.08.02 Adapter shortcut opens the TBF Adapter Console, which provides a command line view of transaction data.

Note: This Adapter Console is not available if TBF is installed as a service. However, the console data is available through the wrapper.log files. See “Logging” in the TBF Product Overview for details.

The TBF 2.08.02 Configuration shortcut opens the TBF Application Properties dialog box, which can be used to configure TBF functionality such as queues, database connections, and logging.

The TBF 2.08.02 Error Utility shortcut opens the error utility. See “Error Logging” in the TBF Product Overview for details.

If the shortcuts are not installed, the Adapter Console and the Application Properties dialog box can also be accessed from the Windows Start menu in All Programs > Travelport > Travelport Booking Feed 2.08.02.

16. Database Management Scripts

The installation also includes scripts to “Select All” and “Purge Data” from the client database.

By default, the SelectAll.sql and PurgeData.sql Microsoft SQL Server scripts are located in: C:\Program File\Galileo International\GIDS\sql_scripts\SQL Server.

By default, the SybaseSelectAll.sql and SybasePurgeData.sql Sybase Adaptive Server scripts are located in: C:\Program File\Galileo International\GIDS\sql_scripts\Sybase.

17. If you chose to Skip the automatic database installation/update in Step 12, you must manually install or update the database schema. See “Manually Installing/Updating the Client Database” on page 15 for instructions.

18. For new installations, the ODBC connection must be set up after the TBF installation. This connection allows the client database to communicate with the Galileo or Apollo data source. See “Setting Up the ODBC Connection” on page 16 for instructions.

Note: For updates of existing installations, confirm that the ODBC connection is working properly.



Configuring the TBF Adapter

After the TBF installation is compete, the TBF Application Properties dialog box automatically displays.

This dialog box can also be accessed from the TBF 2.08.02 Configuration shortcut or from the Windows Start menu in: All Programs > Travelport > Travelport Booking Feed 2.08.02 > Configuration.



Confirm or modify the following configuration options.

Option Description

Queue Name The customer-specific TBF queue for receiving data. The queue name is provided to customers before installation.

Database Reconnect Wait Time

The wait time, in seconds, that the Client Adapter waits to retry the database connection if a failure occurs.

The default wait time is 120 seconds.

MQ Reconnect Wait Time The wait time, in seconds, that the adapter Client Adapter waits to retry the MQ Series connection if a failure occurs. The MQ Series connection is what connects the customer’s site to their data queue.


Message Retry Wait Time This is the wait time, in number of seconds, which the Client Adapter waits to retry a failed message. A retry can occur when a non-fatal error is received from the database.


ODBC Database Name The database connection that is defined in the ODBC parameters of the Windows control panel. This connection is used by TBF to access and update the customer’s database.

The default name is GIDS.

MQ Channel Name A communication channel name used by MQ Series to set up the proper protocols for the MQ Series queue connection. This field is provided for possible future client configuration changes.

The default value for this field is GIDSCHANNEL and should not be changed.

MQ Host Name The name of the server that hosts the MQ Series queues. This field allows Support to redirect the Client Adapter to the Copy or Development MQ servers if required.

The production server DNS name is varies depending on connectivity:

For SSL connections, set to 127.0.01.

For direct/unmanaged VPN connections, set to GIDSMQ.GALILEO.COM.

Host XML Message Logging

When selected, writes all incoming messages to XML log files.

By default, log files are located in \Program Files\Travelport\Travelport Booking Feed\logs. The naming convention for these files is Msg1.xml, where T is the Transaction ID.

Note: This log should be turned on only if directed by Support for problem resolution.

JDBC Message Logging When selected, writes all JDBC errors to the JDBC.txt file.

By default, JDBC.txt is located in \Program Files\Travelport\Travelport Booking Feed\ logs.

Note: This log should be turned on only if directed by Support for problem resolution.

Unique Booking/Fare Records

When selected, makes booking and fare event transactions unique in the database by removing any prior version of the PNR/BF.

Disable Data Base Updates When selected, the database is not updated, which allows data to be stored exclusively through XML logging.



Manually Installing/Updating the Client Database

By default, the TBF installation programmatically creates or updates the client database installation for Microsoft® SQL Server®. See “Software Prerequisites” on page 2 for a list of recommended databases.

However, if you chose not to run the database scripts automatically during the installation, i.e., if you pressed Skip in Step 12 of the installation on page 9, you must manually install or update to the database. In this case, the changes to the client database schemas must be manually configured to allow new data content to be stored.

By default, all database scripts required to build the database are located in C:\Program Files\Galileo International\GIDS\sql_scripts, where C: in the hard drive in which the TBF application is installed.

To manually install or update the client database:

Note: It is not necessary to export existing data. Changes to the schema will result in null values in new columns for existing data rows in tables that are updated.

1. From the TBF database server or a machine with remote connectivity to the TBF database, invoke your database interface tool of choice, such as Microsoft® SQL Server® Enterprise Manager.

2. Open a connection to the TBF database and open a SQL Query Analyzer, if necessary.

3. Open (or cut-and-paste) the SQL alter script using the following format, where script is the script file.

For Microsoft SQL Server databases, use: <InstallationDir>\Galileo International\GIDS\sql_scripts\SQL Server\script.sql.

For Sybase databases, use <InstallationDir>\Galileo International \GIDS\sql_scripts\Sybase\script.sql.

The alter scripts vary depending on the type of TBF installation:

For upgrades from GIDS version 2.04 and earlier, run the following scripts: alter_2.05.sql airsegoperatingcarrier_script.sql obfees_script.sql

For upgrades from TBF version 2.05, run the following scripts: airsegoperatingcarrier_script.sql obfees_script.sql

For new installations, run the following script: databaseCreate.sql

If the update is not applied to the database schema, the TBF Adapter will not collect the new data on inbound transactions, resulting in errors. The entire transaction does not fail, however, warning messages are returned for the affected schema. For example:

WARNING : Air Segment Operating Carrier update available, however AirSegOperatingCarrier table not created in the database. If you want to use Air Segment Operating Carrier, please create table using SQL script otherwise ignore. Remaining information updated successfully.

ID = 1

To eliminate these errors, the database schema can be updated at any time after installation.



Setting Up the ODBC Connection

For new installations, after the database server is configured the ODBC connection must be set up. This connection allows the client database to communicate with the Galileo or Apollo data source. For updates of existing installations, confirm that the ODBC connection is working properly.

This setup is not required for TBF configurations that receive a direct XML log feed, which requires no database or ODBC connection.

The instructions for this also task vary depending on the operating system. This section provides instructions for setting up the ODBC connection in both 32- and 64-bit operating systems.

Setting Up the ODBC Connection in a 64-Bit Operating System

Due to a deficiency in the Microsoft 64-bit ODBC driver, Microsoft recommends that the ODBC system DSN should be run using 32-bit ODBC drivers. Using the 32-bit drivers will eliminate errors received in the TBF console and logs that indicate ODBC driver errors.

To set up the ODBC connection in a 64-bit operating system:

Microsoft recommends that you DO NOT use the Data Source configuration tools normally found in Administration Tools.

Instead, run the ODBC configuration tool, which is typically found in C:\Windows\SysWOW64\odbcad32.exe. When opened, this tool defaults to Windows 32-bit ODBC driver, SQLSRV32.DLL.

After running the executable for the 32-bit driver, the DSN can be configured using the same parameters provided in the following instructions for 32-bit operating systems. Skip Steps 1–3 in Setting Up the ODBC Connection for a 32-bit Operating System, and begin with Step 4 to ensure that you are configuring the 32-bit driver.

There are no additional changes required to configure the database and server for 64-bit systems.



Setting Up the ODBC Connection in a 32-bit Operating System

The following example sets up an ODBC connection, GIDS, for a machine that:

Runs SQL Server on the same machine as the TBF Adapter.

Note: Remote connections will require a slightly different setup.

Uses Microsoft® SQL Server® 2005.

Note: The location of the ODBC application may vary depending upon the version of Windows you are using.

To set up the ODBC connection in a 32-bit operating system:

1. From the Windows Start menu, open the Control Panel.

2. Double-click the Administrative Tools icon to open the Administrative Tools folder.

3. Double-click the Data Sources (ODBC) icon.



The ODBC Data Source Administrator window displays.

4. Select the System DSN tab.

5. Click Add.



The Create New Data Source dialog box displays.

6. From the list of drivers, select SQL Server.

7. Click Finish to open the Create a New Data Source to SQL Server wizard.

8. In Name, enter the same name that you used enter for the ODBC Database Name field in the TBF Application Properties window (page 13).

Note: The default ODBC name is GIDS.

9. In Description, enter a description for this ODBC connection.



10. In Server, click the arrow to select the database server name. Unless the defaults were changed during the SQL Server database installation, this server will be the database machine name.

Note: If the database is running on the same machine as the TBF Adapter, you can select (local).

11. Click Next to display the database selection dialog box.

12. Select the Change the default database to option.

13. Click the drop-down arrow to select your database.

Note: The default database name is GIDS, unless you modified the default settings when creating the database.

14. Click Next to display the language and settings dialog box.

15. Select any additional options you require.

16. Click Finish to display a list of your selected configurations in the ODBC Microsoft SQL Server Setup window.



17. Confirm your settings, and then click Test Data Source to test your database connection.

If the setup is successful, a confirmation displays.

18. Click OK on Test Data Source window.

19. Click OK on the ODBC Microsoft SQL Server Setup to complete the setup.



Running the TBF Adapter After successfully installing and configuring the Client Adapter, client database, and ODBC connection, you can start the Client Adapter.

Note: The TBF Adapter Console (page 13) is not available if TBF is installed as a service. However, the console data is available through the wrapper.log files. See the “Logging” section of TBF Product Overview for details.

If running TBF as a Windows service, the service opens with the Windows startup, if chosen. Confirmation of a successful start up, connection to TBF server, and queue connection, as well as other positive acknowledgments can be viewed in wrapper.log.

To start the TBF Adapter:

Open the TBF Adapter from the TBF 2.08.02 Configuration shortcut or from the Windows Start menu in All Programs > Galileo International > Travelport Booking Feed 2.08.02.

If the TBF Adapter starts successfully, the following message displays:

The waiting for message… line is present until a message is placed on the TBF queue. After a message is received, a transaction number is assigned to the message and displays on the screen. For example, the first three messages will display:

ID=1

ID=2

ID=3

These messages correspond to the TransactionOrderIdentifier field in the database.



Uninstalling the TBF Adapter Important! The TBF adapter must be uninstalled before installing an upgraded version of TBF; the TBF installation does not automatically uninstall previous versions of TBF.

To uninstall the TBF adapter:

1. Before uninstalling the TBF adapter, it is recommended that you record your TBF Configuration (page 13), so that the existing configuration can be duplicated for the new installation.

2. From the Windows Start menu, select Control Panel.

3. From the Control Panel window, select Add or Remove Programs to display the Add or Remove Programs dialog box.



4. From the Currently installed programs list, select Travelport Booking Feed to display the Travelport Booking Feed InstallShield Wizard.

5. Select Remove and click Next. (Do NOT select Modify or Repair.)

6. A Confirm Uninstall message displays. Click OK to confirm.

7. Restarting the machine is recommended, but not required, to ensure that the TBF adapter and its files have been completely removed.

travelport booking feed (tbf) · product has remained the same; therefore, travelport booking feed...

Documents