dle02-187 v4.3 uk -...

Département Infrastructures Marines et Numériques

Unité Navires et Systèmes Embarqués

Service Ingénierie des Logiciels Embarqués

Auteur :Marie Paule CORRE

Octobre 2013- DOP/CB/NSE/ILE/DTI/02_187 version 4.3

CASINO+

INSTALLATION MANUAL

© IFREMER

Tous droits réservés. La loi du 11 mars 1957 interdit les copies ou reproductions destinées à

une utilisation collective. Toute représentation ou reproduction intégrale ou partielle faite par

quelque procédé que ce soit (machine électronique, mécanique, à photocopier, à enregistrer ou

tout autre) sans le consentement de l'auteur ou de ses ayants cause, est illicite et constitue une

contrefaçon sanctionnée par les articles 425 et suivants du Code Pénal.

© IFREMER

All rights reserved. No part of this work covered by the copyrights herein may be reproduced

or copied in any form or by any means – electronic, graphic or mechanical, including

photocopying, recording, taping or information and retrieval systems- without written

permission.

CASINO+

INSTALLATION MANUAL

Installation manual Version : 4.3

3/29

Contents

1 General points............................................................................4

1.1 Document presentation ......................................................................................4 1.2 Terminology and acronyms ................................................................................5 1.3 Document history ..............................................................................................6

2 Purpose of the software ..............................................................7

3 Software architecture .................................................................8

3.1 The configuration module ..................................................................................8 3.2 The acquisition and storage module ....................................................................8 3.3 The archived data processing module ..................................................................8

4 Installation .................................................................................9

4.1 Installation of MySQL .......................................................................................9 4.2 CASINO+ Installation .......................................................................................17

4.2.1 Modules Installation ..........................................................................17 4.2.2 How run a module?............................................................................20 4.2.3 Precise on the Exploitation module .....................................................20 4.2.4 Data time-stamping............................................................................20 4.2.5 Preparing the configuration file of the acquisition.................................20 4.2.6 Acquisition configuration ...................................................................22 4.2.7 Configuring data access......................................................................24 4.2.8 Configuration on a remote workstation ................................................26 4.2.9 Configuring printing ..........................................................................27

4.3 CASINO+ Uninstalling ......................................................................................28 4.3.1 With the uninstallation application in the Windows start menu ..............28


4/29

1 General points

1.1 Document presentation

This document constitutes the CASINO+ software installation manual. It presents

comprehensive instructions for installing not only the software, but also the tools

necessary for CASINO+ to run properly.


5/29

1.2 Terminology and acronyms

JRE Java Runtime Environnent

MySQL Open source database system marketed by the Swedish

company MySQL AB.

VM Virtual Machine: software package used by a Java

program to run itself.


6/29

1.3 Document history

Version Date Sections

modified

Comments

V 0.1 September 2002 1st working draft

V 0.2 September 2002 All 2nd

working draft following proofreading by

Guillaume CLODIC and Antoine COLLET

V 2.0 August 2003 All Implementation of CASINO+ on L’Atalante:

• Removal of Microsoft Server

• Processing of TECHSAS frames.

V 3.0 October 2004 All Implementation of CASINO+ on La

Thalassa:

• Removal of Microsoft Server

• Processing of TECHSAS frames.

• Use of MySQL 4.0

V 3.1 May 2005 All • Use of MySQL 4.1.11

• Use of JAVA 1.5.0

• Automatic migration of past

missions

• Correction of past Thalassa

missions

V 4.0 November 2005 All • A few details added

V 4.2 September 2011 All • A few details added

V 4.3 October 2013 All • Updating


7/29

2 Purpose of the software The CASINO+ software program allows scientists to automatically collect a set of

scientific and technical data, and to record the operations carried out on board during a

mission. This data is time-stamped and georeferenced to help the scientist during

mission analysis.

CASINO+ offers the following services:

• The creation, configuration, opening and closing of one logbook per mission,

• The acquisition, at regular intervals, of various technical and scientific

parameters transmitted over the boat's network,

• Event capture (start/end of profile, start/end of station, operations on a device),

• Subsequent changes and additions to the data already stored,

• Data processing and exporting,

• The creation of a campaign summary.


8/29

3 Software architecture CASINO+ is made up of three software programs, each one providing specific

services:

• The configuration module,

• The acquisition and storage module: acquisition module,

• The archived data processing module: exploitation module.

The three modules are installed individually, each has its setup. They are written in the

Java programming language.

3.1 The configuration module

This module, developed by Ifremer, now allows faster definition of storage

configurations.

This module only works on board the vessels, as it requires the CASINO+ Configurator

program developed by OGS to be started up.

3.2 The acquisition and storage module

This module, developed by Ifreme,r is only implemented on the boats. It allows the

acquisition and storage of the required data in the MySQL database. It is therefore only

set up on the main (or operational) CASINO+ workstation in the scientific control

room.

MANDATORY: MySQL + Acquisition Module have to be installed on the same

workstation . It is the operational PC.

3.3 The archived data processing module

Developed using the Java programming language, this module meets the requirements

expressed by the scientific community with regard to data storage and continuity. The

functionalities offered by CASINO+ and developed by Ifremer are presented in the user

manual.


9/29

4 Installation The first step is to unzip “CASINO+InstallationKit <version >.zip”. This kit is only for

Windows system.

Java Virtual Machine is required but must not be installed; JRE library is included in the

install executable of each module.

The database is administered by the MySQL tool. The MySQL installation procedure is

outlined below.

4.1 Installation of MySQL

The CASINO+ installation CD-ROM contains MySQL version 5.1.54 in the Tools

repository (mysql-5.1.54-win32.zip). To install and use it with CASINO+, you must log

with the property: Administrator. Click on mysql-5.1.54 via CasinoInstall.htm of the

installation kit, download and launch mysql-5.1.54-win32.msi.exe. Earlier versions of

MySQL must be deleted and the machine restarted before installing.

First, click on Next on the welcome screen to continue the installation.


10/29

On the next screen, select the setup type: choose the default setup (Typical), and then

click on Next to go on to the next step.

Click on “Install” to continue.


11/29

Click on “Next” then “Next” then “Next”.

Go on to the MySQL configuration phase by selecting the “Configure the MySQL

Server now” option and clicking on Finish.


12/29

Click on Next.

Choose “Detailed Configuration” then click on Next.


13/29

Choose “Server Machine” then click on Next.

Choose “Non-Transactional Database Only” then click on Next.


14/29

Choose “Decision Support (DSS) / OLAP” then click on Next.

Click on “Next”.


15/29

Choose “Standard Character Set” then click on Next.

Select the “MySQL51 ” service name, then click on Next.


16/29

Enter casino as the root password and retype casino in the password confirmation box.

The casino password is essential to be able to communicate with version 3.1 of

CASINO+. Select the “Enable root access from remote machines” option. Click on

Next to continue.

Click on Execute to apply the configuration and launch MySQL.


17/29

Click on Finish to complete the MySQL configuration.

4.2 CASINO+ Installation

4.2.1 Modules Installation

The three modules must be installed individually, each has its setup

The installation procedure is the same for each CASINO+ module.

Example of the Acquisition module installation:

• Load CasinoInstall.htm of the installation repository in a web browser.

• Click on Configuration module, download and launch CASINO+ Setup-

Acquisition-<version>.exe


18/29

Click on Next.

Click on Next.


19/29

You can change the Start Menu folder

Click on Install.

Click on Next.


20/29

Select Run CASINO+4.3 – Acquisition os 32 if you want to run the application.

Click on Finish.

Now execute CASINO+ Setup-Configuration-<version>.exe then CASINO+ Setup-

Exploitation-<version>.exe

4.2.2 How run a module?

The Execution of a module is performed by using:

• The shorcut on the desktop (Ex: CASINO+4.3 – Acquisition os 32).

• The Windows start menu. A folder exists for each module (Ex: CASINO+

4.3/CASINO+4.3 – Configuration os 32) and contains the launching application

(Ex: CASINO+4.3 – Configuration os 32).

4.2.3 Precise on the Exploitation module

Exploitation module allows to store data of a cruise from the operational database in a

local database (on a external disk for example). This operation must be performed on

the operational workstation, which allows the transcoding of the data from the

operational database to a local database.

To be able to process the data at the end of the mission, the post-processing workstation

must host both the CASINO+ Exploitation module and the MySQL software.

4.2.4 Data time-stamping

The archiving system uses the workstation’s system time to time-stamp the data: it is

therefore important that the PC’s time be set to GMT.

Three files are used for configuring the acquisition, locating the MySQL database, and

configuring the information viewing workstation: data.xml, mysql.properties, and

application-defs.props.xml respectively.

4.2.5 Preparing the configuration file of the acquisition

Data acquisition requires the presence of the data.xml file in the acquisition module’s

installation directory (Ex: C:\Program Files (x86)\CASINO+\CASINO+4.3 -


21/29

Acquisition os32), This file, generated by the CASINO+ Configuration module,

contains information about the data to be acquired.

The module allows:

• Update the data.xml file by loading this one in the configuration module. Indeed

the information on the data to be acquired are enriched with son of

developments in the CASINO+ Exploitation module. It is possible than using a

higher version of the Exploitation module an updating of the data.xml file is

required.

• Add or remove data to be acquired in the data processing module . This requires

load the data.xml file in the configuration module then check or uncheck the

boxes of data to be acquired.

Figure 1: Configuration GUI


22/29

4.2.6 Acquisition configuration

The data.xml file, located in the acquisition module’s installation directory (Ex:

C:\Program Files (x86)\CASINO+\CASINO+4.3 - Acquisition os32), lists the data to

acquire:

The properties.xml file, located in the acquisition module’s installation directory (Ex:

C:\Program Files (x86)\CASINO+\CASINO+4.3 - Acquisition os32), lists several

pieces of information:


23/29

The timer field defines the acquisition period (30sec. by default).

The mysql.operational.properties, mysql.operational.local files, located in the data

processing module’s installation directory (Ex: C:\Program Files

(x86)\CASINO+\CASINO+4.3 - Exploitation os32), configure access to the MySQL

database.

.

This file contains the IP address of the MySQL database host server. This IP address

can be found by running the ipconfig command on the server, via a CommandTool


24/29

window. On the operational PC (MySQL + Acquisition Module) the IP adress of

MySQL is localhost.

4.2.7 Configuring data access

The application-defs.props.xml file, located in the data processing module’s

application directory (Ex: C:\Program Files (x86)\CASINO+\CASINO+4.3 -

Exploitation os32) and the properties.xml file located in the acquisition module’s

application root director (Ex: C:\Program Files (x86)\CASINO+\CASINO+4.3 -

Exploitation os32), configures the location of the machine that hosts the MySQL

database for consultation.

The socket.AcquisitionServer.IpAddress field defines the IP address of the operational

database host server.

The configuration of the directory that holds the MySQL databases (operational and

local) in CASINO+ must match the directories selected during the MySQL installation

(Ref. 4.1 Installation of MySQL).

The path to the data depends on two factors:

• The Windows version

• The MySQL version

To simplify the choice of access to MySQL data, two distinct paths are shown in the

properties file:


25/29

• One for Windows 7 with the variable “mysql.local.windows7.data.directory”

which by default is configured with the default path of MySQL 5.1 on Windows

7

• One for Windows XP with the default variable

“mysql.local.windows.data.directory” which is set with the default path of

MySQL 5.1 on Windows XP.

So if the data access directory needs to be changed and the module is installed on a

platform;.

• Windows 7 : then you must change the value of the property

“mysql.local.windows7.data.directory.

• Windows XP : then you must change the value of the property

“mysql.local.windows.data.directory”.

properties-defs.props.xml for the Acquisition module:

properties-defs.props.xml for the Exploitation module:


26/29

4.2.8 Configuration on a remote workstation

Example of a configuration on a remote workstation on a ship (IP address of the

CASINO+ operational workstation: 134.246.246.266).

Only Mysql and the Exploitation module must to install on the remote workstation.

The following files must be modified.

The mysql.operational.properties file:

The application-defs.props.xml file:


27/29

4.2.9 Configuring printing

The following property, found in the application-defs.props.xml file located in the

data processing module’s application directory, lets you enable or disable the printing

icon.


28/29

4.3 CASINO+ Uninstalling

The unstallation of a module is performed by using:

• The Uninstall a Program control panel of Windows.

• The uninstallation application in the Windows start menu (Ex: CASINO+

4.3/CASINO+4.3 - Acquisition os32/ Uninstall CASINO+4.3 - Acquisition

os32)

4.3.1 With the uninstallation application in the Windows start menu

Example with the Acquisition Module.

For example select in the Windows start menu CASINO+ 4.3/CASINO+4.3 -

Acquisition os32/ Uninstall CASINO+4.3 - Acquisition os32


29/29

dle02-187 v4.3 uk -...

Documents

Transcript of dle02-187 v4.3 uk -...