Tf2.0 User Manual-Installation Guide

Installation and upgrade
procedures
User Manual TF2.0 & TFSvr 3.0 Upgrade & Installation - Page 2 of 16

Version History
Date Revision TF Version Author(s)
March 2013 Draft A 2.0.0 build 2002 T. Sanerkin

Contents
Version History ........................................................................................................................................ 2
Contents .................................................................................................................................................. 3
1. Overview ......................................................................................................................................... 4
1.1 Windows Compatibility ........................................................................................................... 4
1.2 Software Rebranding .............................................................................................................. 4
1.3 Code Consolidation ................................................................................................................. 4
1.4 Code Signing ............................................................................................................................ 4
2. Triggerfish Installation .................................................................................................................... 4
2.1 Install Triggerfish ..................................................................................................................... 5
3. Triggerfish Server Installation ......................................................................................................... 6
3.1 Install TriggerFish Server ......................................................................................................... 6
3.2 Database Location ................................................................................................................... 8
3.3 Configure The Server (first time usage) .................................................................................. 8
3.3.1 Default User Details ........................................................................................................ 8
3.3.2 Time Server Details ......................................................................................................... 8
3.3.3 Status Broadcast Network .............................................................................................. 8
3.4 Configure the Server (from system tray icon)......................................................................... 9
3.5 Starting & Stopping The Server ............................................................................................... 9
3.6 Database location ................................................................................................................. 11
3.7 Configure the Client Connection (first time usage) .............................................................. 11
3.8 Configure the Client Connection (from system tray icon) .................................................... 12
3.9 Starting & Stopping The Client Connection .......................................................................... 13
4. Transferring Survey configuration ................................................................................................ 14
4.1 Copying The Database Files .................................................................................................. 14
5. Windecoder ................................................................................................................................... 15

1. Overview
TriggerFish 2.0 and TriggerFish Server 3.0 are major releases addressing Windows 7/8 compatibility
issues, software rebranding, code consolidation and code signing.
1.1 Windows Compatibility
Issues with user access rights which cause problems with server client connections have been
rectified. The location of the database items for server and client applications has been moved to
the Program Data folder (Application Data folder in Win XP). The changes are backward compatible
with Windows XP although some specific user operations required for correct operation.
1.2 Software Rebranding
The Hydra server system has been modified and rebranded as Triggerfish Server for the server
application. The Hydra Proxy (Client) process has been rebranded as Triggerfish Client Connection. As
in earlier versions, the server application is a separate installer package and the client application is
installed with the main TriggerFish installer. There are several changes to the way these systems are
installed, configured and monitored.
The software has been comprehensively rebranded to reflect the InProspect company name and
there are changes to the names and locations of installation and data folders.
1.3 Code Consolidation
The Windecoder process has been incorporated into the main TriggerFish code and is installed with
TriggerFish in the same installer package. It is now provided as a servlet under the control of the
Triggerfish Services (Servlet Manager) application and is configured via the System Editor
application.
1.4 Code Signing
A code signing certificate verifies the code is genuine with Microsoft Corp. and is expected to
prevent problems with security features in current and future versions of Windows.
2. Triggerfish Installation
Prerequisites:-
Ensure that the Windows system user installing the software has admin rights to the computer and
that there is an active network adaptor available on the computer. Turn off any firewalls.

Because of changes to the database folder location, it is important that surveys and vessel
configurations are backed up prior to upgrading to TF2.0 and TFSvr 3.0. (See 4.
Transferring Survey Configuration.)

2.1 Install Triggerfish
Run the installation package:-

Click next Set the Installation folder (or use default) and click next

The TriggerFish files are installed The package includes the required DirectX components

Click finish to complete the installation.

The Triggerfish Client Connection Manager Icon will now appear in the system tray.

The Client Connection Manager (TFishProxyManager.exe) process should not be confused with the
client connection process itself (TFishProxyServer.exe). The connection manager process only
provides configuration and control for the client connection application. The Client Connection
Manager is started automatically from the Windows Startup folder and can be started manually
from that menu location also if the connection manager is stopped for any reason.

3. Triggerfish Server Installation

Prerequisites:-
Ensure that the Windows system user installing the software has admin rights to the computer and
that there is an active network adaptor available on the computer. Turn off any firewalls. Only one
server should be running on the TriggerFish network.
Because of changes to the database folder location, it is important that surveys and vessel
configurations are backed up prior to upgrading to TF2.0 and TFSvr 3.0. (See 5.
Transferring Survey Configuration.)
3.1 Install TriggerFish Server

Run the installation package:-


Click next

Set the Installation folder (or use default) and click next

The software will be installed

Click Finish to complete the installation.

The Triggerfish Server Manager Icon will now appear in the system tray.

The Server Manager (TFishServerManager.exe) process should not be confused with the server
process itself (TFishServer.exe). The manager process only provides configuration and control for the
server application. The Triggerfish Server Manager is started automatically from the Windows
Startup folder and can be started manually from that menu location also if the Server Manager is
stopped for any reason.

3.2 Database Location

The server database will be created in the in the folder:-
C:\ProgramData\InProspect\TFishServer (Windows 7)
C:\Documents and Settings\All Users\Application Data\InProspect\TFishServer (Windows XP)

In TF1.0 versions the database was stored in C:\Hydra by default
3.3 Configure The Server (first time usage)

From the programs menu select Triggerfish Server/Configure

3.3.1 Default User Details
3.3.1.1 Username
This should be the admin level user, or default login user on the Windows system.
3.3.1.2 Domain
This is the domain or machine name or machine IP address
3.3.2 Time Server Details
Enter the unit and card ID of the GTU or decoder card from which system time is to be
derived.
3.3.3 Status Broadcast Network
Invoke the selection dialogue by clicking on the
browse button and then select the required
network adaptor form the list. This is the network
formally called Windows Client in TF1.0. This is the
network over which configuration and display
information is sent.

3.4 Configure the Server (from system tray icon)

The configuration menu can be accessed by right-clicking on the server icon in the system tray.

For Windows XP systems, the Run As
dialogue will be invoked when the
configuration item is accessed via the system
tray. The user may either un-tick Protect my computer
and data..., or select the required system user (this will
prompt for user login password, if no password has been
set for the user, this option cannot be used).

3.5 Starting & Stopping The Server
The server process may be stopped or started from the program menu item

The server may also be stopped and started from the icon in the system tray. Note the same Run
As options for Windows XP are presented.

The server status is shown in the system tray.

3.6 Database location

The server database will be created in the in the folder:-
C:\ProgramData\InProspect\TFishProxy (Windows 7)
C:\Documents and Settings\All Users\Application Data\InProspect\TFishProxy (Windows XP)

In TF1.0 version the client connection cache files were stored in C:\Hydra Client by default.
3.7 Configure the Client Connection (first time usage)

From the programs menu select Triggerfish/Client Connection/Configure

In Central Server Location click the browser button and
search on the network for the machine where the
TriggerFish Server is running (this can be the same
machine as the client connection), then click OK. The
server machine must be discoverable for this step to
work.


In Windows Client Network click the browse button and
select the network adaptor address whichh will be used
for the connection, then click OK.
Note:- the least significant octet of the IP address is
show as 0 once the setting has been submitted. This
denotes the sub-net on which the connection will
operate.
The windows client subnet must correspond with the
Status Broadcast Network defined in the TriggerFish
Server settings.

In SensorData Network click the browse button and
select the network adaptor address whichh will be used
for the sensor data connection (this can be the same
subnet as the Windows Client Connection) then click
OK.
Note:- the least significant octet of the IP address is
show as 0 once the setting has been submitted. This
denotes the sub-net on which the connection will
operate.

3.8 Configure the Client Connection (from system tray icon)

The configuration menu can be accessed by right-clicking on the server icon in the system tray.


3.9 Starting & Stopping The Client Connection
The client connection process may be stopped or started from the program menu item

The client connection may also be stopped or started from the icon in the system tray. Note the
same options for Windows XP are presented.
prompt for user login password, if no password has been set for the user, this option cannot be
used).
The server status is shown in the system tray.

4. Transferring Survey configuration
For the first time upgrade from the TF1.7 to TF2.0, the survey configuration should be transferred
from the existing Hydra database to the new TriggerFish Server database. It is important to do this
immediately after installing the TF2.0 and TFSvr 3.0 for the first time.
This procedure will only be fully successful if the same configuration settings are to be
carried forward from the original TF1.7 installation; i.e. username, domain and network.
The existing Hydra database in C:\Hydra does not have to be deleted. It is recommended
that the C:\Hydra folder contents are allowed to remain on the system until the upgrade has been
successfully completed. Thereafter, the folder C:\Hydra and subfolders can be archived and removed
from the system. It is also advisable to back-up surveys using the Survey Editor Backup feature and
export vessel configuration to XML file.

4.1 Copying The Database Files

The contents of the TF1.7 database can be transferred to the TF2.0 Server databases by copying all
folders and .hyd files from the Hydra Server cache location (usually C:\Hyrda)

And copying the contents to the new folders created when TF2.0 and TFSvr 3.0 were installed.
C:\ProgramData\InPropsect\TFishServer (Win 7)
C:\Documents and Settings\All Users\Application Data\InProspect\TFishServer (Windows XP)

For the TFish Server database

&
C:\ProgramData\InPropsect\TFishProxy (Win 7)
C:\Documents and Settings\All Users\Application Data\InProspect\TFishProxy (Windows XP)
For the TFish Client Connection cache database

5. Windecoder
The Windecoder process now resides as a TriggerFish Servlet and is started from the System Editor
as below.
The decoder is then configured in the System Editor as in previous TFish version.

Tf2.0 User Manual-Installation Guide

Enviado por

Dados do documento

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Tf2.0 User Manual-Installation Guide

Enviado por

Direitos autorais:

Formatos disponíveis

Installation and upgrade

Você também pode gostar