Scribd
Upload
51 views

A0205e-1 Cetrics DBBackupTool UserManual

This document is a user manual for Cetrics DBBackupTool. It describes how to use the tool to backup the Cetrics database in either windows or batch mode. The tool stores configuration settings like backup directories and logging settings in an XML configuration file. It allows scheduling automated backups using the batch mode and Windows scheduler.

Uploaded by

Aung
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
51 views

A0205e-1 Cetrics DBBackupTool UserManual

This document is a user manual for Cetrics DBBackupTool. It describes how to use the tool to backup the Cetrics database in either windows or batch mode. The tool stores configuration settings like backup directories and logging settings in an XML configuration file. It allows scheduling automated backups using the batch mode and Windows scheduler.

Uploaded by

Aung
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 16

Cetrics DBBackupTool

User Manual
Rev 0.1
Cetrics DBBackupTool UserManual

Contents
1. Introduction................................................................5
1.1 About the User Manual........................................5
1.2 Contact.................................................................5

2. Overview....................................................................6
2.1 The configuration file..........................................6

3. Cetrics DBBackupTool in windows mode................9

4. Cetrics DBBackupTool in batch mode...................12

5. Appendix.................................................................13
5.1 Configuration file example................................13


Cetrics DBBackupTool UserManual

1. Introduction
Thanks for using Cetrics DBBackupTool.

1.1 About the User manual


This user manual describes how to use the program Cetrics
DBBackupTool.

1.2 Contact
For further information and technical support please contact
Cewe Instrument.

World Wide Web http://www.ceweinstrument.se


E-mail
Technical support [email protected]
Order and product information [email protected]

Phone +46 (0) 155 77500


Fax +46 (0) 155 77597

Address Cewe Instrument AB


Box 1006
SE-611 29 Nykping
Sweden


Cetrics DBBackupTool UserManual

2. Overview
DBBackupTool is used to perform backups on the Cetrics
database.

The program Cetrics DBBackupTool can be used in two modes,


in window mode and in batch mode. Both modes are described
further in the following chapters.

When using the program in windows mode the location where


to save the backups in (i.e. the base directory for the backups).
In contrast when using the program in batch mode only backups
will be done with the configured paths.

2.1 The configuration file


The program stores information in the configuration file named
DbBackupTool.exe.config which is located in the Cetrics main
directory (C\Program\Cewe\Cetrics by default) and is a XML
based file.

The configuration file is used to store information about the


backup directories and when and where the last backup was
done. An example of the configuration file is located in the
chapter 5.1.
In this file there are user settings and application settings.

2.1.1 User settings


The user settings Fullbackup1, Fullbackup2 and LatestBackup

Cetrics DBBackupTool UserManual

are settings that are used for saving timestamps when backups
have been done in the corresponding directories. These settings
shouldnt be changed by the user.

2.1.1.1 DbPath
Setting where the path to the base directory where the backups
will be saved. Default value is the Cetrics database directory
(e.g. C:\Program\Cewe\Cetrics\Database).

2.1.1.2 NextBackupDir
Setting that indicates in what directory the next backup will be
saved.

2.1.1.3 LogToFile
Setting that indicates if logging to file should be done. Observe
that the file is not restricted to a certain size and will grow.
Default value is FALSE.

2.1.2 Application settings


The application settings can be changed before the program is
started otherwise the changed parameters wont be active until
the program is restarted.
If one of the settings BACKUPDIR1 or BACKUPDIR2 is
change it is advisable to change the user setting NextBackupDir
so it corresponds to one of these new settings.


Cetrics DBBackupTool UserManual

2.1.2.1 BACKUPDIR1
Setting that indicates the first backup directory.

2.1.2.2 BACKUPDIR2
Setting that indicates the second backup directory.

2.1.2.3 DSN
Setting used to store the data source name (DSN) of the
Cetrics database, if this setting is empty the default name
(Cetrics) will be used. Change the value line from <value /> to
<value>DsnName</value> and change DsnName to the desired
value.

2.1.2.4 LogFile
Setting that stores the file where loggings will be written to,
default value is DBBackupTool.log.


Cetrics DBBackupTool UserManual

3. Cetrics DBBackupTool in windows mode

In windows mode the user can change the base directory where
the backup directories will be created. Logging can be turned on
by checking the checkbox next to the backup button. Logging
will be written to the indicated log file.

If the user enters an invalid path in the input field the backup
button will be disabled and the labels that indicate the backup
paths will be coloured red as follows.

Cetrics DBBackupTool UserManual

If the database couldnt be found the backup button will be


disabled and the status bar will indicate it as follows.

When the backup button is enabled it is possible to perform a


backup by pressing the backup button. By pressing the backup
button a popup confirmation dialog will be shown.

10
Cetrics DBBackupTool UserManual

If the Cancel button is pressed the backup will be aborted, if the


OK button is pressed a backup of the database will be done and
a dialog will appear with the result.

11
Cetrics DBBackupTool UserManual

4. Cetrics DBBackupTool in batch mode

In batch mode the program reads the configuration file and does
a backup and shuts down. The batch mode can be useful when
using the Windows scheduler to schedule backups.

To use the program in batch mode the argument s (for silent)


has to be passed to the program as shown below.

12
Cetrics DBBackupTool UserManual

5. Appendix
5.1 Configuration file example

<?xml version=1.0 encoding=utf-8 ?>


<configuration>
<configSections>
<sectionGroup name=userSettings
type=System.Configuration.UserSettingsGroup,
System, Version=2.0.0.0,
Culture=neutral,PublicKeyToken=b77a5c561934e089>
<section name=DbBackupTool.Properties.
Settings type=System.Configuraion.
ClientSettingsSection, System, Version=2.0.0.0,
Culture=neutral,PublicKeyToken=b77a5c561934e089
allowExeDefinition=MachineToLocalUser require
Permission=false />
</sectionGroup>
<sectionGroup name=applicationSettings
type=System.Configuration.Application
SettingsGroup, System, Version=2.0.0.0,
Culture=neutral,PublicKeyToken=b77a5c561934e089>
<section name=DbBackupTool.Properties.
Settings type=System.Configuration.
ClientSettingsSection, System, Version=2.0.0.0,
Culture=neutral,PublicKeyToken=b77a5c561934e089
requirePermission=false />
</sectionGroup>
</configSections>
<userSettings>
<DbBackupTool.Properties.Settings>
<setting name=DbPath serializeAs=String>
<value>C:\Program\Cewe\Cetrics\Database</value>
</setting>
<setting name=NextBackupDir
serializeAs=String>
<value>FullBackup1</value>

13
Cetrics DBBackupTool UserManual
</setting>
<setting name=FullBackup1serializeAs=String>
<value />
</setting>
<setting name=FullBackup2serializeAs=String>
<value />
</setting>
<setting name=LatestBackupserializeAs=String>
<value />
</setting>
<setting name=LogToFileserializeAs=String>
<value>False</value>
</setting>
</DbBackupTool.Properties.Settings>
</userSettings>
<applicationSettings>
<DbBackupTool.Properties.Settings>
<setting name=BACKUPDIR1serializeAs=String>
<value>FullBackup1</value>
</setting>
<setting name=BACKUPDIR2serializeAs=String>
<value>FullBackup2</value>
</setting>
<setting name=DSN serializeAs=String>
<value>CertricsNo</value>
</setting>
<setting name=LogFileserializeAs=String>
<value>DbBackupTool.log</value>
</setting>
</DbBackupTool.Properties.Settings>
</applicationSettings>
</configuration>

14
Cewe Instrument AB
Box 1006 SE-611 29 Nykping SWEDEN
Tel: +46 155 775 00 Fax: +46 155 775 97
e-mail: [email protected] www.ceweinstrument.com
A0205e-1

You might also like