SETUP GUIDE. BALTECH-Expert software

Size: px

Start display at page:

Download "SETUP GUIDE. BALTECH-Expert software"

Garry Simmons
5 years ago
Views:

1 SETUP GUIDE software 2017

Copyright 2017 BALTECH All rights reserved No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any language in any form by any

3 Copyright 2017 BALTECH All rights reserved No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any language in any form by any means without the prior written permission of Baltech. Trademark The BALTECH trademark is officially registered in Russia, CIS countries and in the territory of the European Union. Other registered trademarks, logotypes and names specified in this document are property of their owners.

4 Responsibility The information contained in this operation manual may be changed at the discretion of BALTECH GmbH without prior notice. BALTECH GmbH doesn t take any responsibility for any damages, direct or indirect, that might be originated from use of the information contained in this operation manual. Technical support If any assistance is required please address to BALTECH GmbH. Please specify the software version number, which can be found out by calling the dialogue About. Describe the problem in details: What error messages appear? (if possible, copy the error message and send it by ). When does the problem occur? Try to estimate if the problem is repeating. Please prepare the problem report and send it to the following address: info@baltech.biz. The BALTECH Expert software update is provided for free. To receive the latest version of the operation manual and installation file please visit our website go to the Contacts and fill in the Contact Form.

5 Main offices Russia Baltech LLC. Chugunnaya 40, , Saint-Petersburg Tel./Fax: web: Kazakhstan ТОО «BALTECH - Kazakhstan» Astana, prospect Pobedy (prospect Zhenis) 79б, office No.104 Tel./Fax: +7 (7172) , , info@baltech.kz, web: Germany BALTECH GmbH Germany, 23560, Lübeck, Kronsforder Allee, 45 Tel.: +49 (0) , Fax: +49 (0) info@baltech.biz, web:

6 Content 1. Introduction Structure of the opearion manual Content of the installation medium Hardware requirements Requirements to the users Quick installation and configuraion of the database server Preparation Quick installation of the MySQL components Step-by-step installation of the DBMS and ODBC driver Preparation Installation of MySQL Upgrade, deletion and reinstallation of MySQL Configuration of the MySQL server MySQL ODBC driver installation Installation of the BALTECH Expert software Preparation Step-by-step installation of the Program start-up options Additional executable files Additional information on DBMS setup Auxiliary components 39 6 Content

7 1. Introduction This operation manual describes the procedure of installation, upgrade and deletion of the software. The information is intended both for end users and for specialists who perform configuration and administration of the databases. Besides the compulsory components, The software is compatible with additional applications that are installed and set up additionally to facilitate work with the software, e.g. a text editor for report editing. The software works with the database which is managed by the MySQL Database Management System (DBMS). For accessing the database management system the Open Database Connectivity (ODBC) is used. To connect the Baltech instruments to your computer an additional driver installation can be required. During the installation it is important to observe the installation procedure. BALTECH Expert should be installed after the MySQL DBMS and ODBC driver are installed and set. Introduction 7

8 1.1. Structure of the operation manual The section 2 describes the quick setup of the required components using a command script. This installation method is preferable for users with basic skills in MS Windows operating system when the software is installed on a computer for the first time. The section 3 Step-by-step installation of the DBMS and ODBC driver contains the detailed information on the step-by-step installation and setup of the MySQL and ODBC driver. This installation method can be used if it is necessary to reinstall the previously installed components and to set up the configuration parameters. The installation and configuration of the database server should be carried out by a database administrator. The section 4 describes the procedure of installation, upgrade and deletion of the software. It also contains the information on how to run the software Content of the installation medium The BALTECH instruments are supplied with the USB-disk or CD which contains the installation package of the software and the installation files of other components. The upgrade file for the software can be provided electronically. The required installation files will be located in the archived file. The installation files of the optional components may be removed from the archived file. 8 Introduction

9 The figures in the names of the software components denote the current version of the component and can differ from those specified in this manual. The installation medium contains: 1) The software compulsory components are located in the MySQL folder: The script for the quick setup of the database server and ODBC driver (command file Install.cmd). MySQL (installation file «mysql win32.msi») MySQL ODBC driver (installation files «mysql-connector-odbc win32.msi» or «mysql-connector-odbc winx64. msi» depending on the version of the operaing system) 2) The installation package of the software is located in the BALTECH folder: The Installation Wizard (executive file «Setup_ BALTECH Expert_ exe») 3) The drivers for connecting the instruments are located in the Drivers folder. 4) The auxiliary components facilitating the work with the software are located in the Misc folder. 5) The manuals are located in the Docs folder Hardware requirements The following requirements must be met to ensure the correct installation and smooth operation of the software: Introduction 9

10 Table 1. Hardware requirements Operating system MS Windows XP Professional SP2 и SP3, MS Windows 7 Professional SP1, MS Windows 7 Ultimate, MS Windows 7 Enterprise, MS Windows 8 Professional, Windows 10 Pro CPU Speed Memory Network Screen resolution USB Drive Free space on the disc 1,5 GHz or higher 2 Gb or larger Ethernet (TCP/IP) XGA (1024 x 768) or higher USB 2.0 for the data interchange with the instruments CD-DVD drive to install the CD with the installation package (*) 1 Gb or larger for database storage (*) in case the files are located on CD-ROM 1) The network is required for the distributed work, when the database server is installed on a separate computer. 2) Required free space does not allow for increase size of database long-term. The user must self-dependent control the availability of free space Requirements to the users The user should have the basic skills in MS Windows operating system. Installation and reinstallation of the software components related to the databases, configuration of the distributed work as well as database archiving and backup require advanced skills such as administration of the Windows operation system and database server. The user who has only basic skills in the MS Windows operation system should address to the IT engineer. 10 Introduction

11 2. Quick installation and configuration of the database server 2.1. Preparation Make sure that your computer meets the above mentioned requirements. If the software or the MySQL database management system have been already installed on your computer, a new installation with the script is not required. The further description assumes that the compulsory components are NOT installed and the user registers in the Windows system with the administration rights. The installation of MySQL with the install.cmd script will automatically set all the basic parameters and settings required for the software operation. Quick installation and configuration of the database server 11

12 1. It is not recommended to run the script using other file managers (e.g. Far or Total Commander that have their own command shell) and network drives as during the installation the MS Windows current global settings must be changed. 2. You can run the script from the MS Windows command line. 3. When working in the MS Windows (not applicable to MS Windows XP) the current parameters of the User Account Control (UAC) may prompt for permission to run the installation packages during the script realization. In this case the user should confirm the installation of the software Quick installation of the MySQL components 1. Insert the CD (or other data medium) with the distribution package. 2. Open the MySQL folder and run the Install.cmd file. 3. Wait till the MySQL and MySQL ODBC driver are installed and set up. Then install the software as described in the section. 4. In this case the section 3 should be missed. 12 Quick installation and configuration of the database server

13 The database server is configured automatically with the following settings of the administration access to the databases: Login: root Password: root Quick installation and configuration of the database server 13

14 3. Step-by-step installation of the DBMS and ODBC driver 3.1. Preparation Make sure that your computer meets the above requirements. The user should register in the MS Windows system with the administration rights. When working in the MS Windows (not applicable to MS Windows XP) the current parameters of the User Account Control (UAC) may prompt for permission for run of the installation packages during the script realization. In this case the user should confirm the installation of the software Installation of MySQL When installing the ODBC on a new computer we recommend that you use the installation method described in the section 1. Below is a detailed description of the server installation. If you install the MySQL version other than the one which is delivered with the software, make sure that the version is not lower than 5.0.The version higher than 5.5. may fail to operate in the MS Windows XP. 14 Step-by-step installation of the DBMS and ODBC driver

15 1. Insert the CD (or other data medium) with the software. 2. Open the MySQL folder and run the «mysql win32.msi» file. 3. The welcome window will appear. Press Next to go to the next step. Step-by-step installation of the DBMS and ODBC driver 15

These options are described below. 4. Mark the field I accept the terms in the License Agreement.

16 If you run the Installation Wizard again, for example, after the server has been automatically installed with the script (see Section 1), you will be offered to change, repair or delete the MySQL. These options are described below. 4. Mark the field I accept the terms in the License Agreement. Press Next to go to the next step. 5. Press Typical to perform the setup with the default setting. 16 Step-by-step installation of the DBMS and ODBC driver

17 6. Press Install to install the server. 7. During the installation a window MySQL Enterprise will appear. Close this window by pressing Next or «x». Step-by-step installation of the DBMS and ODBC driver 17

18 8. Press Finish. We recommend that you mark the field Launch the MySQL Instance Configuration Wizard to go to the configuration and run of the MySQL server. The installation is completed. The configuration of the MySQL server is described in the next section Upgrade, deletion and reinstallation of MySQL If MySQL version 5.0 or higher is already installed on your computer a new installation of MySQL IS NOT REQUIRED. Make sure that the path to the executable files of MySQL is written in the system. If the installed version differs from version on the CD (for example, the version 5.0. is already installed, while the CD contains the 5.5 version) then the installation of MySQL from the CD is not recommended. This section describes the repeated run of the installation file with the same version as has been already installed on the computer. The sub versions can differ. For example, a version is installed, while a new file version is Step-by-step installation of the DBMS and ODBC driver

19 1. The welcome window will appear. Press Next to go to the next step. 2. To change the installed parameters press Change. To fix issues or to upgrade press Repair. To delete the MySQL server press Remove. Step-by-step installation of the DBMS and ODBC driver 19

3. Next steps depend on the selected option and are not described in this section. Upon completion press Finish to exit the Setup Wizard. 3.4.

$In case of typical installation of the database server MySQL in the 32-bit version of MS Windows the file is located in the C:\ Program Files\MySQL\MySQL Server 5.$

20 3. Next steps depend on the selected option and are not described in this section. Upon completion press Finish to exit the Setup Wizard Configuration of the MySQL server To work with the software the MySQL database server should be set up properly. The MySQL Wizard runs right after the DBMS is installed. If you need to perform the configuration separately, run the MySQLInstanceConfig.exe executable file. In case of typical installation of the database server MySQL in the 32-bit version of MS Windows the file is located in the C:\ Program Files\MySQL\MySQL Server 5.5\bin folder. To configure the server perform the following: 20 Step-by-step installation of the DBMS and ODBC driver

1. Press Next to go to the next step. 2. After the MySQL server has been configured and run, the Configuration Wizard offers two options: reconfiguration or configuration removal.

21 1. Press Next to go to the next step. 2. After the MySQL server has been configured and run, the Configuration Wizard offers two options: reconfiguration or configuration removal. For initial configuration this step is missing. To remove the configuration it is necessary to select Remove Instance and perform further steps, exit the Configuration Wizard and reload the computer. This procedure is not described in details. Step-by-step installation of the DBMS and ODBC driver 21

Mark the field Include Bin Directory in Windows PATH.

22 3. For the initial configuration we recommend that you select the standard configuration. Mark the field Standard Configuration and press Next to go to the next step. 4. Mark the field Include Bin Directory in Windows PATH. Be sure to tick the item «Include Bin Directory in Windows PATH». Press «Next» go to the next step. 5. Enter the password and confirm the password. 22 Step-by-step installation of the DBMS and ODBC driver

23 It is necessary to set the administrative password for work with the database server. If the configuration of the database server has been made before the old password should be entered into the Current root password field. 1) If the configuration has been made before during the script execution (see Section 1), then the password is already set. Enter the root password into the Current root password field. 2) We recommend that you use the root password. 3) If the server configuration is made to enable the work with the server via the network, mark the field Enable root access from remote machines. The password should be entered in the lowercase letters. The letters are not displayed during the password input, therefore make sure that the proper keyboard case is selected. Step-by-step installation of the DBMS and ODBC driver 23

Insert the CD (or other data medium) with the software. 2. Open the MySQL folder and run the «mysql-connector-odbc-3.51.

24 6. Press Execute to configure and run the database server with the specified settings. 7. Press Finish. The configuration and run of the MySQL database server have been successfully done MySQL ODBC driver installation 1. Insert the CD (or other data medium) with the software. 2. Open the MySQL folder and run the «mysql-connector-odbc win32.msi» or «mysql-connector-odbc winx64.msi» depending on the version of the operating system. 24 Step-by-step installation of the DBMS and ODBC driver

will be offered to change, repair or delete the driver. These options are not described in this manual.

25 3. The welcome window will appear. Press Next to go to the next step. 1) If you run the Installation Wizard again, for example, after the driver has been automatically installed with the script (see Section 1),you will be offered to change, repair or delete the driver. These options are not described in this manual. 2) The work with the software has been tested only with the ODBC driver version The upgrade may result in failure in operation of the software. 4. Select Typical and press Next to go to the next step. Step-by-step installation of the DBMS and ODBC driver 25

26 5. Press Install to install the driver with the default settings. 6. Press Finish to exit the Wizard. The MySQL ODBC driver is successfully installed! 26 Step-by-step installation of the DBMS and ODBC driver

27 4. Installation of the software 4.1. Preparation Make sure that your computer meets the above requirements. Further description assumes that the user registers in the MS Windows system with the administration rights. When working in MS Windows (not applicable to MS Windows XP) the current parameters of the User Account Control (UAC) may prompt for permission to run the installation packages during the script realization. In this case the user should confirm the installation of the software. The following components should be already installed before the installation of the software: 1) MySQL database management system and 2) MySQL ODBC driver. Installation of the software 27

28 If you upgrade the software, before running the installer run the and make the backup copy of the database. Depending on the version of the software to be installed the conversion of the existing database may be required to enable the smooth operation of the software with the new functions. Such conversion is not made automatically. For this address to the software developers Step-by-step installation of the 1. Insert the CD (or other data medium) with the installation package. 2. Open the BALTECH folder and run the «Setup_BALTECH Expert_ exe» file. 3. Select the language. The English language is selected by default. Press Next to go to the next step. 28 Installation of the software

29 Press Next to go to the next step. 4. After choosing a language the installer checks MySQL installation. The table below shows messages that will be displayed if there are any problems with MySQL and recommedation how to solve this problem. In case of detection of these problems the installation of should be interrupted and the recommendation should be completed. An exception is using with a remote MySQL server. In this case installation can be continued without paying attention on the message. Message MySQL isn t installed! Please follow the manual to install Recomendation It is required to install MуSQL. Refer to Section 2 of this manual. MySQL before setup. MySQL service isn t running! Please run MySQL service before setup. It is required to start the MySQL service. The server configuration may not be completed. Use the standard features of the Windows operating system to start the service. Installation of the software 29

30 MySQL wasn t configured! Please launch «MySQLInstanceConfig. exe» and configure the server The server configuration is not completed. Refer to Section 3.4 of this manual. following the manual before setup. MySQL password isn t correct! Please launch «MySQLInstanceConfig. exe» and change the password for root user before setup During server configuration the password set for the user root does not match with the BALTECH- Expert program by default. It is required to change the password by setting a new password «root». To change the password use the MySQLInstanceConfig utility. Error on checking correct MySQL instance! Please follow the manual to install MySQL before setup The installer could not determine which problem occurred during the checking of MySQL working efficiency. Try installing MySQL again. If the problem persists, contact technical support. 5. Press Next to go to the next step. 30 Installation of the software

31 6. Press Next to go to the next step. 7. Enter the username and company name, press Next to go to the next step. Installation of the software 31

This option can be selected if you upgrade the software.

32 8. Press Next to go to the next step. 9. Press Next to go to the next step. 10. If you select the Minimal installation, the test database will not be created. This option can be selected if you upgrade the software. For the new installation we recommend that you select the Typical installation. Custom type of the installation allows to enable/disable technologies and to choose required components. 32 Installation of the software

Select the type of installation and press Next. If you select the Custom installation, the next step will be the selection of installation components.

33 Select the type of installation and press Next. If you select the Custom installation, the next step will be the selection of installation components. The user can cancel the test database installation (TestDB option), add or exclude the possibility of connecting devices and additional program components within different technologies. Press «+» to open pop-down menu, select or disable required options. The image below shows the selection of options for Vibration technology, RealTime installation and connection with BALTECH VP If no component of the technology is selected, this technology will be disabled in. Installation of the software 33

34 11. Press Next to go to the next step. 12. Press Install to start the installation process. 34 Installation of the software

35 13. Wait till the installation process is completed and press Finish. The is successfully installed! 4.3. How to run the software During the installation the Setup Wizard creates a test database (if the Typical installation was selected) and registers it as a resource of the ODBC data with the RESOURCE name. For work with the remote server it is necessary to register the resource. The work of the software with the database is performed via the ODBC driver. The main run file is located in the installation directory: wxbaltech-expert.exe. To run the software the following parameters are required: username (root is on default) password (root is on default) name of the data resource (RESOURCE is on default) The shortcut is located on the desktop. Installation of the software 35

$To set up the software work with the remote database server it is necessary to set up the database resource: «C:\Program Files\BALTECH Expert\wxBALTECH Expert.exe» -d resource -u root -p root.$

36 When running the software by using the shortcut the below window appears: Enter the username and password. Press OK. To set up the software work with the remote database server it is necessary to set up the database resource: «C:\Program Files\BALTECH Expert\wxBALTECH Expert.exe» -d resource -u root -p root. Explicit user and password setting in the tag line reduces the safety of working with the database. Such launch is not recommended when working with corporate database server. To set up the software work with the remote database server it is necessary to set up the database resource: 1. Open the MS Windows control panel and go to Administrative Tools. 36 Installation of the software

Enter the hostname (where the MySQL database server is run) into the Server field. 5.

37 2. Run the administration utility ODBC Data Sources and go to the tab System DNS. 3. Select the data resource with the RESOURCE name and press Configure. 4. Enter the hostname (where the MySQL database server is run) into the Server field. 5. If during the set up of the remote server other username and password were used, they should be entered Additional executable files Besides the main executable file there are the following files in the installation directory: Installation of the software 37

1) wxchartview program for graphic data view 1) wxrealtime program for real-time data analysis To view the archive data it is necessary to run the wxchartview program with the -a (--archive)

38 1) wxchartview program for graphic data view 1) wxrealtime program for real-time data analysis To view the archive data it is necessary to run the wxchartview program with the -a (--archive) parameter. This program can be also run directly from the BALTECH Expert software when viewing the historical data. The wxrealtime program can be used to connect the BALTECH VP-3470 vibrometer-balancer for the data acquisition control in real time Additional information of DBMS setup On default during the installation of the MySQL version 5.5 or lower, the maximum size of the record is 1 mb. This parameter should be increased to enable the storage of the infrared images taken from the infrared cameras with the 640x480 resolution. Open the my.ini file which is located in the folder where the MySQL was installed (e.g. «C:\Program Files\MySQL\MySQL Server 5.5\» ) and after [mysqld] insert :max_allowed_packet=4m. During the installation of the MySQL server using the script, necessary changes will be made automatically. If the server was installed separately, edit the server initialization file. Restart the MySQL server (for example by reloading the computer). 38 Installation of the software

39 5. Auxiliary components The auxiliary components are located in the Misc folder on the CD with the BALTECH- Expert software. These components are designed to improve the work with the software: The auxiliary components are: 1) LibreOffice_5.3.4_Win_x64.msi and LibreOffice_5.3.4_Win_x86.msi (to install LibreOffice), 2) SumatraPDF install.exe and SumatraPDF install.exe (to view documents in the.pdf), 3) Proton.oxt (to install LibreOffice, it is designed to save the reports from the software in the PDF). Auxiliary components 39

3M Molecular Detection System Software Upgrade/Installation Instructions

User Manual Supplement Number: TB.342837.03 Effective Date: March 2018 Supersedes: TB.342837.02 Technology Platform: 3M Molecular Detection System Originating Location: St. Paul, MN 3M Molecular Detection