tf2.0 user manual-installation guide.pdf

8/17/2019 TF2.0 User Manual-INSTALLATION GUIDE.pdf

1/16

Installation and upgrade

procedures


2/16

User Manual –TF2.0 & TFSvr 3.0 –Upgrade & Installation - Page 2 of 16

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


3/16



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


4/16



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 andthat 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.)

http://www.google.co.uk/url?sa=i&rct=j&q=warning+icon&source=images&cd=&docid=OFtSypHgfpSE5M&tbnid=VWVQvzJrT815fM:&ved=0CAUQjRw&url=http://archive.foolz.us/q/thread/105837&ei=AnEzUYG8CuqZ0QWK-IHACA&bvm=bv.43148975,d.d2k&psig=AFQjCNHEnPYPwNLSMOsO7FI5M4C7XmCG_g&ust=1362412154189473


5/16



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.


6/16



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:-



7/16



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.


8/16



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.


9/16



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



10/16



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.

For Windows XP systems, the “Run As”

dialogue will be invoked when the






The server status is shown in the system tray.



11/16



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.


12/16



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.


13/16






tray. The user may either un-tick “Protect my computerand data...”, or select the required system user (this will



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.






http://www.google.co.uk/url?sa=i&rct=j&q=warning+icon&source=images&cd=&docid=OFtSypHgfpSE5M&tbnid=VWVQvzJrT815fM:&ved=0CAUQjRw&url=http://archive.foolz.us/q/thread/105837&ei=AnEzUYG8CuqZ0QWK-IHACA&bvm=bv.43148975,d.d2k&psig=AFQjCNHEnPYPwNLSMOsO7FI5M4C7XmCG_g&ust=1362412154189473http://www.google.co.uk/url?sa=i&rct=j&q=warning+icon&source=images&cd=&docid=OFtSypHgfpSE5M&tbnid=VWVQvzJrT815fM:&ved=0CAUQjRw&url=http://archive.foolz.us/q/thread/105837&ei=AnEzUYG8CuqZ0QWK-IHACA&bvm=bv.43148975,d.d2k&psig=AFQjCNHEnPYPwNLSMOsO7FI5M4C7XmCG_g&ust=1362412154189473


14/16



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)



15/16



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.


16/16

