volume 1 - installation guide - mantaray software

Integrated Business SolutionsIntegrated Business SolutionsIntegrated Business SolutionsIntegrated Business Solutions

Volume 1

Installation Guide

Mantaray Software Sàrl

Version 6

May 2013

Mantaray Installation Guide

of 41

This document contains proprietary information that is protected by copyright. No part of this document may

be photocopied, reproduced, or translated without the prior written consent of Mantaray Software. The

information contained in this document is subject to change without notice.

Mantaray Software provides this material as is and makes no warranty of any kind, expressed or implied,

including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose.

Mantaray Software shall not be liable for errors contained herein or for incidental or consequential damages

(including lost profits) in connection with the furnishing, performance, or use of this material whether based

on warranty, contract, or legal theory.

Windows TM

is a trademark of Microsoft Corporation.

Copyright © 2001-2010 by Manuel Goeyers.

Copyright © 2010-2012 by Mantaray Software Sàrl.

Mantaray Software Sàrl

133, route de Diekirch

L-7220 Walferdange, Luxemburg

www.mantaray.lu

[email protected]


of 41

Table of Contents

INSTALLATION 7

Single Client Installation 9

Installation Procedure 10

Network Structure Installation 13

Server Installation 13

Client Installation 19

License Key Installation 23

Database Initialization 25

IMPORTING DATA 35

Prepare the data files 35

Interface Definitions 35

PART I

Installation


of 41

Installation

of 41

Installation

This manual will guide you through the process of installing Mantaray successfully in your organization.

There are two types of installations possible:

• Single Client Installation

Mantaray is installed on each computer separately. There will be no automatic update possible for

client computers.

However, the database can be shared on a network server.

• Network Structure Installation

Mantaray is installed on a deployment server in order to dispatch client computer and in order to keep

the client computers updated.

The database is located on the same deployment server or on a separated database server.

Depending on the size of the company complex confirgurations can be made in order to ensure data security

and integrity.

For large databases it is recommender to separate the installation over several servers:

• Deployment Server: Ensures the same client versions are used.

• Database server: A separated server to ensure high performances.

• Knowledge Base Server: A separated server that contains the knowledge base documents accessed by

the database.

Mantaray Installation Reference

of 41


of 41

Single Client Installation

A single client installation is done by installing Mantaray on each computer separately.

In order to keep the computers updated with the latest Mantaray version each time each computer will need

to be updated.

Client

Install

Client

Install

Client

Install

After installation each computer will need to be configured in order to access the database.

The database can be configured locally on the same computer, or on a shared location of a server.


of 41

Installation Procedure

Insert de CD-ROM in your PC drive, the installation program should execute automatically. If the installation

program is not started automatically, double click the install.exe icon on the CD- ROM directory.

The language selection screen is displayed:

Select the installation language you wish to use to perform the installation.

Note: The installation language is not the language of the application but from the installation program.

The following screen is displayed:

Enter the installation directory and select to install to display the next screen.


of 41

Note: We recommend to use the default installation directory.

Select to continue the installation processes, no data should be entered here.

Select to continue the installation processes, no data should be entered here.


of 41

Select the <DONE> button to close the installation program and to start Mantaray.


of 41

Network Structure Installation

By installing Mantaray on a deployment server the client computers will be kept automatically up to date each

time a new version is installed on the deployment server.

Also, a deployment server can be used to disconnect user from the database in case of problems.

Client

Deployment

Client

Deployment

Client

DeploymentServer Install

Server Installation

Create a dedicated directory on the server e.g. "\Mantaray\Deployment". Make sure the directory is shared

and accessible from all client computers.

Insert the installation media like a CD Rom or USB Drive into the server that you wish to use as deployment

platform, the installation program should execute automatically. If the installation program is not started

automatically, double click the install.exe icon on the CD Rom directory.

The following dialog box is displayed:


of 41




Enter the complete path towards the deployment server including the host name.

In the example shown the installation will be made in the "Mantaray\Deployment" directory on server

"SERVERTSC".

Select in order to accept the entered data and move to the next screen:


of 41

Enable the "Reference the application in the User Control Center". This will give you the access to monitoring

tools in order to perform various database administration functions.

Enter the directory where the Control Center data files will be located.

In the example shown the installation will be made in the "Mantaray\Control" directory on server

"SERVERTSC".



of 41

If required you can enable versioning of installed updates.

If enabled you will be to perform a roll back of the installed version in case of compatibility problems with the

current installed database.



of 41

Review the data and select in order to accept the entered data and move to the next screen:

Select in order to confirm and start the actual installation.


of 41

Once the installation succeeded the following screen is displayed:

Mantaray is now installed on the server and the deployment to the client computers can be started.


of 41

Client Installation

Once the server installation is completed the client installation can start.

From the client computer navigate to the deployment directory located on the deployment server.

In the example shown the client installation is located in the "Mantaray\Deployment" directory on server

"SERVERTSC".

Double click the "INSTALL.EXE" program to start installation.

The following screen in displayed:





of 41

Enter the installation directory and select to install to display the next screen.

Note: We recommend to use the default installation directory.

If existing files are found the installation procedure will propose to make a backup.



of 41

Select the <DONE> button to close the installation program.


of 41


of 41

License Key Installation

At purchase time, a serial number was send to you by Email.

This license key ensures that your copy of Mantaray is valid and that you have access to future updates and

customer support.

When starting Mantaray for the first time the number will be needed in the activation screen. Make also shure

that your computer is connected to the internet.

The license number can be found on the bottom section of the login screen.


of 41


of 41

Database Configuration

Once Mantaray is installed correctly the database can be initialized.

Start Mantaray by selecting the Mantaray icon located in the start menu, the following window will be

displayed:

Figure 1 Login Window

When it is the first time that you launch Mantaray you will have to perform a series of tasks to create a

database with the basic parameters for you company.

The first task is to create the database that will contain your company’s data.

Select the “Admin” button from the login screen, the Mantaray Control Center will be opened:

Figure 2 Control Center


of 41

Select the button, this will invoke the Data manager window.

Using this window you can create databases that match Mantaray’s structure.

Select the “New” button and enter an entity name for your database e.g. MyDataBase. Enter the complete

directory path to the location where you want to store your database.

Figure 3 Database Manager

You database can be stored locally on your computer, but in an multi-user environment you will need to create

the database on a shared network drive.

When all information has been entered select the “Save” button, now select “Create Database”.


of 41

Figure 4 Database Manager – Creation

The database structure will now be created.

Once the database has been created the system will prompt you the following:

Select <Yes> if this is a new database. This procedure will created the default security settings and one

Administrator log-in Id.

When the primary data has been created the system will prompt you the following:


of 41

Select <Yes> if you wish that Mantaray will be started with a default product structure and basic data, like

currency codes, is pre-loaded.

Select <No> if you will start entering all the data manually.

When finished, the login screen is displayed.

Enter “Admin” as user id and “admin” as password.

Select the <OK> button to start the application, the main menu is now displayed.


of 41

Figure 5 MANTARAY Menu Tree

The standard menus, if not available already, must be uploaded into the system. Select “System Menu” from

the main screen, the menu editor is loaded now.

Select “Import Menu” from the drop down menu, the complete menu structure is now loaded.

Congratulations ! You are ready to start using Mantaray.


of 41


of 41

Knowledge Base Configuration

Mantaray uses a directory structure in order to store scanned and imported documents.

For performance reasons it is recommender to configure the knowledge base onto a separated server.

The system control file window is used to configure the location of the knowledge base and the knowledge

base versioning archive.

This configuration program is located in the "Managers Function" tree

of the ERP menu.

Enter the root directory of the knowledge base and the directory where the version archives will be located.

Note: The root and archive directory may be located across several servers.


of 41


of 41

PART II

Importing Data


of 41


of 41

Importing Data

Mantaray has a feature that allows you the import data from other applications into the data base.

In this chapter we will explain how to prepare the data files and how to load them into the database.

Prepare the data files

In order to load the data into Mantaray the data must be organized into “.CSV” files. In “.CSV” or “Comma

Separated Values” files the information is organized in columns that are separated by Commas or semi-colons.

Mantaray can read files separated by semi-colons.

If you export information from another application you must select the delimited export function and specify

that semi-colons must be used as separator.

To create new “CSV” files you can use a text editor or a spreadsheet like Microsoft Excell TM and same the

information by selecting “save as csv”.

The created file must be stored in the “Transfer” directory located in the database directory.

Example: Postal codes file with 1 column for the postal code, one column for the city description and one

column for the country code.

The file is called “Postalcodes.csv”.

1000;Brussels;BEL

3000;Antwerp;BEL

9000;Ghent;BEL

Interface Definitions

Once the data files are created they must be imported into Mantaray.

In order to import the data, you have to define where the information is located in the “CSV” files. Open the

“Interface Maintenance” window, located in the following menu path: System Administration, User Interface,

Interfaces, Specifications.

This window is used to specify which system table will be updated and which of the columns contains the key

field.

Example: Postal Codes.

Select the system table “Zip” which will contain the postal codes and “Zip” which is the Key-field for that table.

In our definition of the file we’ve placed the key-field in the first position, sequence is then 1.

Set the interface mode to “Replace Data”, this means that the new data will be added and existing data will be

replaced.

The filename is “Postalcodes.csv”.


of 41

Figure 6 Interface Maintenance

The interface main information is now created, select the <DETAILS> button to define the data fields and select

<NEW>.

The following window is now displayed:

Figure 7 Interface Details Maintenance


of 41

Enter for each column in the “CSV”-file and entry in this window and specify the system fieldname and position

in the “CSV”-file.

For our example you should have this result:

Figure 8 Interface Details Browse

The layout of the “CSV”-file is now defined.

We will specify now the order in which the files have to be read.

Open the “Interface Batch Maintenance” window located in the following menu path: System Administration,

User Interface, Interfaces, Batch.

With this window we can specify the interfaces that have to be load and in which order they have to be

loaded.


of 41

Figure 9 Interface Batch Maintenance

For our example we have only one file to load. In the “Interface Batch” window specify “Codes” as the batch

name, select the <DETAILS> button and select the <NEW> button on the browse window.

Figure 10 Interface Batch Detail Maintenance

Select the “Postal Codes” interface and set the sequence to 1. The interface is now completely defined and is

ready to run.


of 41

Select the <READ FILE> button on the interface batch window, the file is now imported into the “ZIP” system

table.


of 41

The Manta Ray

The largest member of the ray family, the manta looks like a giant bat. It has been known to leap out of the water,

occasionally destroying small fishing boats.

The manta ray is found both inshore and offshore in the warmer oceans. Although mantas can be found on the seabed, they

spend much of their time feeding near the ocean's surface. Large species of ray, such as the manta, tend to be solitary,

although they are often accompanied by a shoal of pilot fish. While feeding, small and medium-sized species of ray may form

shoals.

Manta rays bear live young. The single fertilized egg develops inside the mother. The gestation period is unknown. It

appears that mantas do not breed until their wing like pectoral fins reach a length of 13-15 feet. There is no specific breeding

season: males and females mate year round. The newborns are fairly large, weighing 20-30 pounds, have fins that span 4

feet, and can generally protect themselves from predators.

Manta rays feed mainly on shrimp and plankton, although they will occasionally eat small fish such as mullet. The manta's

gill arches help it to feed by operating as a filtration system. During respiration, water is sucked in through the mouth and

pumped out through the gill slits. The plankton that is sucked into the manta's mouth along with the water is caught by the gill

arches and siphoned into its stomach. When mantas encounter a shoal of fish, they quickly move in to feed, swallowing as

many fish as they can.

The manta ray has long been regarded by fishermen as dangerous. Stories of mantas killing scuba divers and deliberately

jumping onto small boats are numerous, but unsubstantiated. However, the manta's habit of circling small boats can be

frightening to those aboard. And, although mantas do occasionally jump onto boats, the damage they cause is thought to be

accidental. In the process of leaping out of the water, done possibly as an aid in giving birth or for sport, manta rays have

wrecked small boats, earning them the name devilish.

KEY FACTS

Size

Length: 10-16 ft.

Span: 14-20 ft.

Weight: Estimated at up to 3,000 lb.

Breeding

Sexual maturity: when wing like pectoral fins reach a length of 13-15 feet.

Mating: year round.

Gestation: Not known.

Number of young: 1.

Lifestyle

Habit: Large specimens solitary; smaller fish may move in shoals of five or six in food-rich areas.

Diet: Mainly shrimp and plankton; occasionally small fish such as mullet.

Lifespan: Not known.

volume 1 - installation guide - mantaray software

Documents