Decoder Suite - Installation Guide
Our Decoder Suite is usually deployed using Microsoft's Click Once technology which allows Navitas Solutions to publish new versions to our central server and have all users automatically upated with the latest features and functionality with minimal overhead.
The following outlines the process required to download and prepare the workstation to run the application.
There are additional instructions provided for customers who utilise a Citrix/Terminal Services type environment.
Pre-Requisites for install
.net Framework
The Decoder Suite has been developed against version 4.6.2 of Microsoft’s framework, so this must be available on the workstation before the application will launch. If the workstation does not have this installed it can be downloaded directly from Microsoft’s website.
Web Services Access
All Navitas Solutions products communicate with a series of web services to access data tables for the purpose of decoding GDS codes and to provide licence control. If your agency has a proxy installed or a firewall that limits internet communication then please see our FAQ page on the https://navitas.zendesk.com/hc/en-us/articles/17115289351441-Navitas-Web-Services-Web-API-Infrastructure for information on the web addresses and ports that need to be configured as either “bypass” or “allow” on your network.
Travelport (Galileo / Apollo) Users Only
The application utilises the latest version of the Desktop XML API which often requires the workstation to be upgraded. Navitas Solutions makes a ‘Pre-Requisites’ installer available on our web site to ensure the workstation has the latest files, please follow the additional steps below
Navigate to https://navitas.zendesk.com/hc/en-us/articles/200592779
Installation Guide - Click Once Deployment
The Decoder Suite installation must be performed on each workstation that requires access to the system
1. Go to https://www.navitas.co.uk/products/decoder-suite#downloads Click the Integrator Install link.
NOTE: For Travelport GDS users please ensure you have closed Galileo Desktop / Smartpoint before running the installation.
You will then get two security warnings, click Run, then Run again.
The installer will launch and open the Welcome page. Click Next to continue.
The installer displays the License Agreement that must be agreed to in order to continue with the install.
Select "I agree to the terms of the license agreement" and click "Next" to continue.
Tick the appropriate box to select if you are an Amadeus, Sabre or Galileo user - select as many boxes as necessary for the specific machine!
The Installer is now ready to perform the installation, click "Next" to continue.
Once complete, the Installation Successful screen is displayed.
Click "Finish" to exit the installer.
NOTE: On some Windows configurations, the Program Compatibility Assistant may display a message to say the program might not have installed correclty - this is in error, simply click "This program installed correctly" to close the installer.
NOTE: The installer automatically adds the required toolbar button for Travelport GDS users. For Amadeus and Sabre users please see the below information on how to configure the toolbar on those GDS environments
If your agency only needs to run the solution from the Start Menu (for example during testing), then after the above instllation has finished, navigate to the c:\navitas directory and double click the 'DecoderSuite.appref-ms' application file to download and install the application directly.
Installation Guide - Citrix / Terminal Services environments
Using Internet Explorer, navigate to https://www.navitas.co.uk/products/decoder-suite#downloads
Scroll to Software and select the 'Citrix XCopy' link to download the ZIP file.
You must mark the download ZIP file as safe BEFORE extracting the contents, so right click on the ZIP file and select PROPERTIES from the menu.
Select the 'Unblock' check box below the advance button, and click Apply.
Expand the contents of the ZIP file into the recommended c:\navitas\NavitasDecoderSuite directory on your server(s).
NOTE: You can choose a different directory if required, but is must be physically on the server where .net 3.5sp1 is installed
Configuring the Start Menu
Once copied, configure the Start Menu with a shortcut to the C:\navitas\NavitasDecoderSuite\DecoderSuite.exe file. If the solution is being tested by a select group of users, then please only make the shortcut available to the individual users. Please see the relevant Appendix to also configure the GDS Toolbar button required to launch the application.
Initiating a ‘First Run’
Due to further limitations with Citrix environments, and as the solution makes use of .net and WPF technologies, the application must be run at least once, by an administrator, on the server. To do this, launch and sign in to the GDS to be used. Double click the c:\navitas\NavitasDecoderSuite\DecoderSuite.exe file so that it is compiled and launches. Once the interface has appeared on screen it can be closed.
Adding a Toolbar Button - Amadeus users
A request needs to be sent through to your Amadeus Account Manager to request a button be added on to the Selling Platform to launch the application. The below text can be sent to your account manager :
For ‘normal’ individual workstations:
<ScriptFolder wcfgIndex="Navitas Scripts">
<Title>Navitas Scripts</Title>
<Position>50</Position>
<ScriptFolderItem wcfgIndex="DecoderSuite">
<Position>4</Position>
<Tooltip>Decoder Suite</Tooltip>
<IconURL>http://www.navitasonline.co.uk/ClickOnce/Images/Decoder.png</IconURL>
<IconDisabledURL>http://www.navitasonline.co.uk/ClickOnce/Images/DecoderBW.png</IconDisabledURL>
<Script wcfgIndex="NavitasDecoderSuite" ScriptMustNotifyCompletion="0">
<ScriptEXE>
<Path>rundll32.exe dfshim.dll,ShOpenVerbShortcut</Path>
<Params>C:/Navitas/DecoderSuite.appref-ms </Params>
</ScriptEXE>
</Script>
</ScriptFolderItem>
</ScriptFolder>
For ‘Citrix’ or ‘Terminal Server’ environments:
NOTE: please adjust the URI information in the <Path> section if you chose to deploy the application to a different directory
<ScriptFolder wcfgIndex="Navitas Scripts">
<Title>Navitas Scripts</Title>
<Position>50</Position>
<ScriptFolderItem wcfgIndex="DecoderSuite">
<Position>4</Position>
<Tooltip>Decoder Suite</Tooltip>
<IconURL>http://www.navitasonline.co.uk/ClickOnce/Images/Decoder.png</IconURL>
<IconDisabledURL>http://www.navitasonline.co.uk/ClickOnce/Images/DecoderBW.png</IconDisabledURL>
<Script wcfgIndex="NavitasDecoderSuite" ScriptMustNotifyCompletion="0">
<ScriptEXE>
<Path>c:\navitas\NavitasDecoderSuite\DecoderSuite.exe</Path>
</ScriptEXE>
</Script>
</ScriptFolderItem>
</ScriptFolder>
Adding a Toolbar Button - Sabre users
To add a toolbar to Sabre Red for launching the Decoder Suite, follow the steps below:
Select, Tools -> Agency Applications -> Configure Agency Applications.
On the Options screen, click the 'Add' button.
To configure the Name and Path of the file use the following:
Name:
Decoder Suite
Path:
(normal worksation) c:\navitas\DecoderSuite.appref-ms
(citrix / terminal services) C:\navitas\NavitasDecoderSuite\DecoderSuite.exe
NOTE: In most cases you won’t be able to use the ‘Browse’ button as this will attempt to point directly to the current version of application and not to the appref-ms file itself. So typing in the path manually is recommended.
Adding a Quick Command - Travelport users
Please refer to our online help page https://navitas.zendesk.com/hc/en-us/articles/360022985731-How-do-I-create-a-Smartpoint-Quick-Command-
Adding a Toolbar Button - Travelport (Galileo/Apollo) users
When using the normal Workstation install, the Travelport toolbar button is automatically created, however for Citrix or Terminal Services environments this needs to be done manually.
NOTE : Before undertaking the steps below, ensure no user is running Galileo Desktop or Smartpoint otherwise the changes made will be overwritten when these applications are next closed.
Navigate to the Application icon using a web browser http://www.navitasonline.co.uk/clickonce/images/btnDecoder.bmp once the icon is displayed, right click and select Save As and save a copy of the file into the c:\fp\swdir\content\toolbar artwork directory on the server.
Copy and paste the following XML snippet into each users Focalpoint toolbar configuration file (the location of this file depends on the agencies individual configuration, but is called focalpoint.config.xml and would normally be stored in the c:\fp\datadir\users\{username} directory).
NOTE : When opening the file, scroll to the end to find the closing </Buttons> XML tag, this text should be pasted in just BEFORE this tag.
<Button>
<Picture><![CDATA[{{ARTWORKDIR}}\\btnDecoder.bmp]]></Picture>
<Transparent>Y</Transparent>
<ActionType>E</ActionType>
<Action><![CDATA[C:\navitas\NavitasDecoderSuite\DecoderSuite.exe]]></Action>
<Argument><![CDATA[]]></Argument>
<ToolTip><![CDATA[DecoderSuite]]></ToolTip>
</Button>
Save the file and the user can now restart Galileo Desktop and see the new toolbar icon allowing then access to the software.
Travelport Users
Travelport users: if this is your first installation of Navitas tools, or you are installing on a new workstation then you will also need to install our "Pre Requisiste" files.
These can be found on our support portal https://navitas.zendesk.com/hc/en-us/articles/200592779