CAT Roof Support VDataSrvDBCache Operation & Maintenance Manual - PDF DOWNLOAD

Media-ID: EM027747-00-EN Doc.-No.: 1999 001 118 BA 00 01 Mar. 2017

Operating and Maintenance Manual VDataSrvDBCache - Buffering process data

SAFETY.CAT.COM

© 2017 CATERPILLAR ALL RIGHTS RESERVED

CAT, CATERPILLAR, THEIR RESPECTIVE LOGOS, ”CATERPILLAR YELLOW“ AND THE “POWER EDGE” TRADEDRESS, AS WELL AS CORPORATE AND PRODUCT IDENTITY USED HEREIN, ARE TRADEMARKS OF CATERPILLAR AND MAY NOT BE USED WITHOUT PERMISSION.

Table of Contents

Table of Contents 1 About this manual ....................................................................................... 5 2 Requirements............................................................................................... 7 3 Installation and configuration .................................................................... 8 4 Buffering files ............................................................................................ 10 5 Setup as service ........................................................................................ 13

Media-ID: EM027747-00-EN / Caterpillar Global Mining Europe GmbH 2017 ©

6 Connection problems................................................................................ 14

VDataSrvDBCache - Buffering process data

4 / 14

VDataSrvDBCache - Buffering process data Media-ID: EM027747-00-EN / Caterpillar Global Mining Europe GmbH 2017 ©

About this manual

1

1 About this manual This manual describes the function, installation and use of the software VDataSrvDBCache with the add-on SyncApp.

Media-ID: EM027747-00-EN / Caterpillar Global Mining Europe GmbH 2017 ©

This software expands the programs VDataSrv and VDataSrvDB. It prevents loss of face data during transport of the data to the surface. No data is lost even in the event of severe problems in the network. VDataSrv continuously receives the process data provided by the face software and creates encrypted SQL instructions for the database VDataSrvDB. These SQL instructions are first saved in a buffer folder underground. The add-on SyncApp retrieves the SQL instructions from this folder and moves them to a buffer folder above ground. At the same time, SyncApp checks for the completeness of the data. After the data has been moved, SyncApp decrypts the SQL instructions and sends them to VDataSrvDB for processing. Now, other applications on PCs above ground can access this database and visualize process data for analyses, for instance, or export the data for further processing.

The following figure shows the path the process data takes from creation at the face to further processing above ground along with the participating applications.

VDataSrvDBCache - Buffering process data

5 / 14

1

About this manual

6 / 14

1

V-software receives process data from the face for visualization.

2

V-software forwards process data to VDataSrv.

3

VDataSrv creates encrypted SQL instructions and writes them to a buffer folder.

4

SyncApp retrieves the SQL instructions from the buffer folder underground.

5

SyncApp writes the SQL instructions to a 6 buffer folder above ground.

SyncApp reads the SQL instructions and decrypts them.

7

SyncApp sends the decrypted SQL instructions to VDataSrvDB.

Client V-programs access VdataSrvDB and prepare the data for further processing (visualization, export).

8

VDataSrvDBCache - Buffering process data

Media-ID: EM027747-00-EN / Caterpillar Global Mining Europe GmbH 2017 ©

Fig. 1: Data flow with VDataSrvDBCache

Requirements

2

2 Requirements Hardware Operating systems Microsoft Windows® 7; 64-bit Microsoft Windows® 10; 64-bit Intel Core i7 or compatible multi-core processor with higher than 3 GHz CPU clock 16 GB RAM

Media-ID: EM027747-00-EN / Caterpillar Global Mining Europe GmbH 2017 ©

Full 3D-capable graphics card with support for Direct X 10.0 and OpenGL ICD (ZBuffer at least 32-bit).

For each visualization program, at least 50 MB free storage space on the hard drive. The required storage space is increased to at least 1 TB if log files (protocols) are written.

Network connection (fiber optic, for connection underground) USB port CD-ROM drive Notice: You will also need an application which unpacks zipped files with the file extension .zip.

Software VDataSrvDBCache is an add-on for VDataSrv with the database VDataSrvDB. VDataSrv must be installed on the master PC underground and operable.

VDataSrvDB must be installed on a client PC above ground and operable and in the same network. If VDataSrv is also installed above ground, the SQL interface there must be deactivated. When using VDataSrvDBCache to buffer data, we recommend that you not install any SQL database (VDataSrvDB) underground.

Depending on the configuration, administrator rights may be required.

VDataSrvDBCache - Buffering process data

7 / 14

3

Installation and configuration

3 Installation and configuration Prior to using VDataSrvDBCache, you must configure the applications VDataSrv and VDataSrvDB appropriately.

Master PC underground VDataSrvDB: See installation instructions in document EM011883.

Important information Use only one database If you use VDataSrvDBCache for data buffering, the database should exist above ground. Do not install a database underground. Deactivate an existing installation underground.

Open "config_vdatasrv.xml" in a text editor and make the following settings in the file (lines 9 and 10): sql enable = "0" (deactivates SQL) filebuffer enable = "1" (activates data buffer) bufferpath = "D:\vcu\VDataSrvBuffer" (alternative, if no drive D:\ is available, "C:\vcu\VDataSrvBuffer") Creating and enabling the buffer folder: Create the buffer folder and make it available to "All" on the local network so that the client PCs above ground can retrieve and delete the buffered data.

Fig. 2: Enabling the buffer folder

A buffer folder is necessary to buffer the process data. Create the folder D: \vcu\VDataSrvBuffer (alternative, if no drive D: available, C:\vcu \VDataSrvBuffer), if not already done.

Important information Pay attention when selecting the buffer folder Pay careful attention to the folder structure if you wish to buffer process data on drive C:. Do not select the folder C:\vcu\VCU\VDataSrvDBCache.

8 / 14

VDataSrvDBCache - Buffering process data

Media-ID: EM027747-00-EN / Caterpillar Global Mining Europe GmbH 2017 ©

VDataSrv:

Installation and configuration

3

Make the buffer folder on the master PC underground available to "All" ("Enabling the buffer folder" [} 8]) and open this folder from the client PC above ground. Test access to the files in this folder. Delete the files in this folder. In Windows Explorer, add the buffer folder as a drive (e.g. Q:).

Client PC above ground VDataSrv: Open "config_vdatasrv.xml" in a text editor and make the following settings in the file (lines 9 and 10): sql enable = "1" (activates SQL) filebuffer enable = "0" (deactivates data buffer) bufferpath = "D:\vcu\VDataSrvBuffer" (alternative, if no drive D:\ is available, "C:\vcu\VDataSrvBuffer")

Media-ID: EM027747-00-EN / Caterpillar Global Mining Europe GmbH 2017 ©

VDataSrvDB: See installation instructions in document EM011883.

VDataSrvDBCache: The installation files are located in a ZIP container. Unzip the ZIP container to a temporary directory and start the setup.exe file. The installation program installs the application at C:\vcu\VCU\VDataSrvDBCache\Version\.

Following successful installation, you can delete the ZIP container in the temporary directory.

A buffer folder is necessary to buffer the process data. Create the folder D: \vcu\VDataSrvBuffer (alternative, if no drive D: available, C:\vcu \VDataSrvBuffer), if not already done.

For more information, see also 2 About this manual [} 6]

VDataSrvDBCache - Buffering process data

9 / 14

4

Buffering files

4 Buffering files Following the configuration settings, it is still necessary to make a few settings in a dialog box of VDataSrvDBCache. Start the application VDataSrvDBCache.exe. The following window appears:

Media-ID: EM027747-00-EN / Caterpillar Global Mining Europe GmbH 2017 ©

Fig. 3: Start window before configuration

The window is divided into four areas: File Transfer Settings Database Settings Current Status Errors

File Transfer Settings Source Directory of Underground PC: You enter the buffer folder on the master PC underground in this field. In this example, the folder D:\vcu\VDataSrvBuffer of the PC underground is mounted on drive Q:\.

However, you can also enter the computer name, followed by the name of the enabled folder: \\MCU2\VDataSrvBuffer or \\MCU2\vcu\VDataSrvBuffer.

It is also possible to enter the IP address if the PC has a dedicated IP address: \\192.168.8.205\VDataSrvBuffer or \\192.168.8.205\vcu\VDataSrvBuffer.

When in doubt, ask your system administrator. The only important point is that VDataSrvDBCache can establish a stable connection to the buffer folder of the PC underground under all circumstances.

10 / 14

VDataSrvDBCache - Buffering process data

Buffering files

4

Destination Directory of Surface PC: You enter the buffer folder of the client PC above ground here. In this example, also D:\vcu\VDataSrvBuffer.

File moved: Here, VDataSrvDBCache shows the file that is currently being moved from the PC underground to the PC above ground.

Database Settings

Media-ID: EM027747-00-EN / Caterpillar Global Mining Europe GmbH 2017 ©

Database Host address: If the database VDataSrvDB is running on the same PC, please enter localhost here. If the database is located on a different PC, you must specify its IP address or the name in the network.

Examples: \\10.82.8.80\vcu\VCU\VDataSrvBD or \\Computername \vcu\VCU\VDataSrvBD Port 5432 is specified by the database and should only be changed in the event of conflicts with other applications.

Status of Database This is not an input field. The application provides information on the status of the connection to the database here.

File processed: Here, VDataSrvDBCache shows the file that is currently being decrypted and forwarded to the database. starting buffering

After you click on the "Start" buttons, the application establishes the necessary connections and encrypts, moves and decrypts the process data, and sends it to the database (see "Data flow with VDataSrvDBCache" [} 6] ( 4 , 5 , 6 , 7 )).

Fig. 4: Buffering

VDataSrv places the files with the process data in the buffer folder on the PC underground. VDataSrvDBCache copies each file to the buffer folder of the PC above ground. If copying is successful, the data is deleted from the underground PC. Processing of the file then starts. VDataSrvDBCache reads and de-

VDataSrvDBCache - Buffering process data

11 / 14

4

Buffering files

crypts the contents and transfers the contained SQL commands to the database. Following successful processing, the file is also deleted from the surface PC.

Current Status This area contains a list of current activities (moving file and decrypting file). To the left, the application displays the date and time for the adjacent activity. The filename of the currently processed file appears to the right.

Example (see figure below): The file 20170220121911.vds was created on 20.02.2017 at 12:19:11 UTC time, moved on 20.02.2017 at 13:21:25 local time and processed a second later (decrypted).

The following figure shows the structure of the filename.

Fig. 5: Filename

second minute hour day month year

Errors If a file cannot be read or processed, a corresponding message appears here.

In this case, the network connection to the master PC underground was interrupted. As soon as the cause of the interruption is rectified, the connection is established again automatically and buffering of the process data continues.

Error messages are retained as long as the application is running.

12 / 14

VDataSrvDBCache - Buffering process data

Media-ID: EM027747-00-EN / Caterpillar Global Mining Europe GmbH 2017 ©

The additional difference of 2 minutes and 14 seconds results from the different time settings on the PCs involved.

Setup as service

5

5 Setup as service You should consult your system administrator to set up the service. He knows the specifics of your network.

If you set up data buffering as a service, buffering starts automatically as soon as the computer starts. You must first modify the file V_ini.xml. Under <AppSettings> set the value for "UseService" and "DebugMode" to "1".

<setting name="UseService" value="1" /> <!-- Use external Service for data --> <setting name="DebugMode" value="1" /> <!-- Show internal debug data -->

Media-ID: EM027747-00-EN / Caterpillar Global Mining Europe GmbH 2017 ©

In VDataSrvDBCache under "File Transfer Settings", set the path to the enabled buffer folder on the PC underground such as (Syntax) the service can access this folder.

Using administrator rights (right mouse button: run as administrator), install the service by executing the file installservice.cmd. The service appears in Windows as CAT_VDataSrvDBCacheService.

Restart VDataSrvDBCache. The application now obtains all the data from the installed service.

You can remove the service by executing the file uninstallservice.cmd (administrator rights necessary).

Alternative to service Using task scheduling (taskschd.msc) in Windows, you can have VDataSrvDBCache start automatically under different conditions. This also requires administrator rights.

VDataSrvDBCache - Buffering process data

13 / 14

6

Connection problems

6 Connection problems The service CAT_VDataSrvDBCacheService normally uses the login data to establish a connection to the PC underground. Whether additional or other data is needed depends on the system environment. The login data can be set in the Properties windows of the service.

Generally, the service uses the predefined Windows account " Network Service".

If the application VDataSrvDBCache cannot establish a connection to the service, it creates a log file containing additional information. The location where this file is saved depends on the operating system. Generally, it is saved in the AppData directory of the user that is specified in the settings for the service. If the user is set to "Network Service", the log file is located in "C:\Windows \ServiceProfiles\NetworkService\AppData\Roaming\VDataSrvDBCache\ServiceMsgs.log". Administrator rights are necessary to access this folder. Please make sure that the hidden directories of the operating system are also displayed - the "AppData" directory is set to "hidden" by default.

14 / 14

VDataSrvDBCache - Buffering process data

Media-ID: EM027747-00-EN / Caterpillar Global Mining Europe GmbH 2017 ©

In the Windows entry prompt, enter services.msc. A list of installed services appears. Highlight the service CAT_VDataSrvDBCacheService and in the "Action" menu select the entry "Properties".