amadeus farexpert - installation guide v2.1uat.farexpert.amadeus.com/netapp/amadeus farexpert... ·...

Amadeus FareXpert

Installation Guide v2.1

Fares, Filing solutions

April 2013

© 2

011 A

mad

eus IT

Gro

up S

A

Amadeus FareXpert Installation Guide v2.1

Fares, Filing Solutions June 2012 Page Nº 2

Table of Contents INTRODUCTION ................................................................................................................. 3

Overview of the Amadeus FareXpert Filing Platform ........................................................... 3

A highly secured application ................................................................................................ 3

HOW TO INSTALL AMADEUS FAREXPERT?.................................................................... 4

Step 1 – Minimal technical requirements ............................................................................. 4

Step 2 – Java Runtime Environment Installation.................................................................. 4

Step 3 – Network Configuration ......................................................................................... 76

Step 4 – Install the certificate............................................................................................. 87

Step 5 - Run a test to confirm all is OK .............................................................................. 98

Step 6 – Launch Amadeus FareXpert application ............................................................ 109

FREQUENTLY ASKED QUESTIONS ............................................................................1211

How to report installation problems? ...............................................................................1211

What do you need to do if Amadeus Support asks you to “clear the Java cache”? .........1211

How can I check that my configuration is OK? ................................................................1312

How to find the local XML log files? ................................................................................1312

How can I provide the content of my console? ...............................................................1413

What happens when there are several certificates on a PC? ..........................................1514

Can I install Amadeus FareXpert on a laptop? ...............................................................1514

Notes for Citrix users ......................................................................................................1514

© 2

011 A

mad

eus IT

Gro

up S

A



INTRODUCTION

Overview of the Amadeus FareXpert Filing Platform Amadeus FareXpert Filing Platform is a set of applications that enable real-time filing directly into the Amadeus database. For productivity and consistency purposes, all applications have been grouped under a unique platform: the Amadeus FareXpert Filing Platform. To have further information about the Amadeus FareXpert Filing Platform, do not hesitate to contact your Amadeus Sales Representative.

A highly secured application Amadeus FareXpert is designed on a 3-level security platform: � User ID and password guarantees dedicated access to

Amadeus FareXpert with specific access rights for each Office ID;

• A given Office ID will have access only to specified FareXpert products and with related restrictions

� A digital certificate (CID) guarantees that the application cannot be installed on another PC only the one specified by the customer;

� The digital certificate is linked to the Windows session of

the customer, preventing another person to log on the same computer.

Office Id level

User level

PC level

© 2

011 A

mad

eus IT

Gro

up S

A



HOW TO INSTALL AMADEUS FAREXPERT?

Before deploying Amadeus FareXpert, please FIRST check that your workstation:

• meets minimal technical requirements

• has the correct Java Runtime Environment installed

• has the correct network configuration to allow communication with Amadeus

• has a valid certificate identifier (CID) installed to use Amadeus FareXpert*

* To obtain a CID from Amadeus, please contact your Amadeus Representative and request access to the Amadeus FareXpert Filing Platform.

Note: If you already have a valid Amadeus Selling Platform CID installed on your workstation, you do not need to request another one for FareXpert.

Step 1 – Minimal technical requirements

Operating system Windows 2000 Professional, Windows XP, or Windows 7 (English versions only are supported)

Processor Minimum Pentium IV 1.5 GHz* Recommended Pentium IV 2.8 GHz* or higher

RAM Minimum 512 Mb Recommended 2GB

Available Hard disk space 500 Mb

Video monitor SVGA

Video memory Minimum 32 Mb Recommended 128 Mb

Screen resolution Minimum 1024*768, 32768 colors Recommended 1280*1024, 32 bits colors

Browser

Internet Explorer 6.0, 7.0, 8.0, 9.0

* or equivalent processor power

Step 2 – Java Runtime Environment Installation

Before installing Amadeus FareXpert, you must have a Java Runtime Environment (JRE) installed on your workstation. Amadeus FareXpert works with JRE 6u7 or any JRE from 7u13. To find out which version of JRE you have:

1. Click on the menu Start > Settings > Control Panel > Java to open the Java Control Panel

2. Click on the "Java" tab

3. Click on the lower "View" button to display the Java Application Runtime Settings:

© 2

011 A

mad

eus IT

Gro

up S

A



Note that you only need one version of Java: 6u07 or a version over 7u13. If Java 1.6.0_07 or any version above 1.7.0_13 (for instance, in the screenshot, we have 1.7.0_17, which is accepted) is not in the list, then please point your browser to http://www.oracle.com/technetwork/java/javase/downloads/index.html and download the latest JRE. Then please install it following the instructions on the screen. We advise you to keep your system up-to-date and to always install the latest version available.

© 2

011 A

mad

eus IT

Gro

up S

A



Note that for retro-compatibility, Java 6u07 is available here: http://www.farexpert.amadeus.com/netapp/jre/jre-6u7-windows-i586-p.exe

For more details

• Contact your company IT responsible;

• In case you are unable to solve your issue with JRE, please contact your local support office or contact the corresponding Amadeus support center.

© 2

011 A

mad

eus IT

Gro

up S

A



Step 3 – Network Configuration

Why do I need to configure my network?

FareXpert needs to establish communication:

• with the FareXpert website

• with Amadeus Central System Depending on your network configuration, your firewall or proxy may block this communication, thus preventing FareXpert from running correctly.

How can I configure my network?

Please, contact your network administrator and communicate the following information: For Internet users:

• Connections to FareXpert URL: www.farexpert.amadeus.com via http(s) protocol through the standard ports 80 and 443.

• Connections on port 24003 on native TCP/IP must be allowed to the IP address 82.150.229.129

For Intranet users:

• Connections to FareXpert URL: www.farexpert.amadeus.net via http(s) protocol through the standard ports 80 and 443.

• Connections on port 24004 on native TCP/IP must be allowed to the IP address 194.76.166.93.

Moreover, some Proxy servers can be configured to block downloads of Java applications. As a symptom, users under such a situation cannot even access the Launcher application. For the record, here are the MIME types that must be allowed:

• application/x-java-archiv

• application/x-java-archive-dif

• application/x-java-jnlp-file

• application/x-java-jnlp-error

Is this communication secure?

Yes. The communication path has been designed to fully protect your data and network. The communication between FareXpert and Amadeus Central System operates via a socket level encryption derived from SSL. There is no unsolicited message coming from Amadeus Central System. Each request originates from the FareXpert application.

For more details

• Contact your company IT responsible

• In case you are unable to solve your issue with network configurations, please contact your local support office or contact the corresponding Amadeus support centre.

© 2

011 A

mad

eus IT

Gro

up S

A



Step 4 – Install the certificate

1. From FareXpert Welcome page click on the 'Requirements' link on the left part of the screen.

2. The installation procedure depends on the Windows version you have. From the 'Security' paragraph please open the Installation guide page. Then:

• If you are using Windows 2000 or XP, please open the Windows XP procedure link.

• If you are using Windows 7, please open the Windows 7 procedure link. Please read thoughtfully the procedure before continuing, and apply the requested configuration in chapter Internet Explorer configuration to your web browser. 3. Click on the link to the Certificate installation site.

4. Install the certificate following your Certificate installation procedure. Important note: CID must be installed under the user's windows session and not under another one (such as the administrator's session).

© 2

011 A

mad

eus IT

Gro

up S

A



Step 5 - Run a test to confirm all is OK 1. Point your browser to the Diagnostic Tool link:

o Internet users: http://www.farexpert.amadeus.com/netapp/diagnostic.html o Intranet users: http://www.farexpert.amadeus.net/netapp/diagnostic.html

2. Click on and then on the 'Start test' button. If all is OK, you will see the following test result and summary:

The Diagnostic Tool will perform several tests that may help identifying any problem you can encounter with FareXpert. You can also perform an Advanced test that will allow you to test your account as well. If needed, you can generate a report and send it to your Amadeus representative for further investigation.

© 2

011 A

mad

eus IT

Gro

up S

A



Step 6 – Launch Amadeus FareXpert application

• Go back to FareXpert Welcome Page and click on the button on the left side of the screen.

On your first launch of FareXpert, you may have a message prompting you for the proxy settings. Refer to your network administrator for the required values.

• The message below will be displayed:

This message ensures you that FareXpert has been signed by Amadeus Global Travel Distribution S.A., which offers a secure and protected product via a certificate. Please verify the message content. It should be the same as displayed in the example above.

• Then click on "Start" to launch the FareXpert application.

• Finally, the sign-in window prompts for the user for the User ID, Organisation and Password:

© 2

011 A

mad

eus IT

Gro

up S

A



Once the user has been identified, the download process will start. When Amadeus FareXpert is launched, you will have access to all the applications you have ordered. Choose one application in the list and click on the “Continue” button.

Important note: Once the user has launched the FareXpert portal for the first time you may need to wait up to 6 hours for the Amadeus security process to be unlocked before being able to save data within FareXpert.

© 2

011 A

mad

eus IT

Gro

up S

A



FREQUENTLY ASKED QUESTIONS

How to report installation problems?

Please contact your local Amadeus support center.

What do you need to do if Amadeus Support asks you to “clear the Java cache”? To retrieve the cache content of Java Web Start: you should launch Java Web Start: click on “Start”, then click on “Run…” and enter “javaws -viewer” in the field finally click on OK. To clean the cache:

� You need to click on “Start”, then on “Settings”, “Control Panel” and “Java”. In the “Temporary Internet Files” box, you have a button named “Settings”. If you click on it, a popup will appear. Click on “Delete Files” button, tick all the boxes and click OK several times to apply and close all windows.

� Alternatively, you can click on “Start”, then click on “Run…” and enter the following command: “javaws -uninstall”.

• You can also do a manual cleaning: open a Windows explorer on the directory C:\Documents and Settings\username\Application Data\Sun\Java\Deployment\cache Replace username by your actual username. Delete the folder 6.0 inside and all its content.

Note: for Citrix users, please refer to the dedicated section below.

© 2

011 A

mad

eus IT

Gro

up S

A



How can I check that my configuration is OK? In order to check if your workstation is correctly configured to run FareXpert, and to diagnose any potential problem, please point your browser to the Diagnostic Tool link:

o Internet users: http://www.farexpert.amadeus.com/netapp/diagnostic.html o Intranet users: http://www.farexpert.amadeus.net/netapp/diagnostic.html

Run an Advanced Test as explained in the Step 5 above. This will show if your configuration is good, or will report any problem.

How to find the local XML log files? You maybe asked by your support center to provide log files to help with reporting issues, First close Amadeus FareXpert before checking these log files and follow the 3 steps below: Note: for Citrix users, please refer to the dedicated section below.

1) Your "hidden files and folders" need to be "shown":

- Open the Control Panel (Start -> Settings -> Control Panel) - Go to “Folder options” (if you do not find it, it is under the “Tools” menu); - Click on the “View” tab; - Make sure that under “Files and Folders/Hidden files and folders”, the "Show hidden files

and folders" option is selected (see after);

2) Search for the FareXpert log files:

- Open a Windows Explorer (Start -> Programs -> Accessories -> Windows Explorer) - Open the following folder, depending on your Windows version:

- For Windows 2000 or XP: %TMP%

© 2

011 A

mad

eus IT

Gro

up S

A



- For Windows 7: %TMP%

This alias will redirect you to the real temporary folder. - Scroll down until you find the FareXpert log files (encircled in blue in the next page

example) - Check the files mentioning dates coherent with your problem. You can sort the files by

date modification if it helps. - Consider only the XML files (below in green) and not the LCK files (below in red) - Attach the corresponding files to your PTR.

How can I provide the content of my console? Support team can ask you to provide the content of your Java console.

1. Exit FareXpert or any other Java application 2. Click on the Windows Start button 3. Go to Settings > Control Panel > Java

© 2

011 A

mad

eus IT

Gro

up S

A



4. Go the "Advanced" tab 5. In the Java console, select Show console, and validate 6. Restart FareXpert. The Java console should automatically pop up:

7. Reproduce the error you are reporting 8. Copy/paste the content of the Java console into a Word or text file.

What happens when there are several certificates on a PC? Amadeus FareXpert can work with several CIDs on one PC. In case you encounter any problem, do not hesitate to contact your Amadeus Support Center.

Can I install Amadeus FareXpert on a laptop? Amadeus FareXpert can be installed on any type of PC, given the fact it meets the minimum hardware requirements (see requirement page of www.farexpert.amadeus.com).

Notes for Citrix users Citrix users can’t have a direct access to their local log files and Java Web Start cache, thus a special control has been implemented. When launching FareXpert through Citrix, the following dialog should pop-up:

The CopyLogs button allows copying the XML FareXpert logs to the user’s H drive, so that they can be provided to Amadeus support for analysis. The ClearCache button allows clearing the Java Web Start cache when requested to do so by Amadeus support.