Estimated reading time: 18 min

Backup and RollbackTo Top

 

Legal WarningTo Top

Specifications, details, statements, and information in this manual are subject to change without any notice. All the information provided, procedures shared, or statements listed below are for Tegsoft technical experts only. Using this manual without Tegsoft Technical qualification should be avoided. Tegsoft has no obligation over the result of the application on any use. Some statements may not be suitable for the use; avoiding without technical qualification may be crucial. Users must take full responsibility for performing any steps part of this manual. Users who are not aware of technical terms and operations described here; should be aware that this document may not be suitable for their usage.

 

Changes to This DocumentTo Top

Date Change Summary
2020-09-01 Initial release of the document.

 

 

 

PrefaceTo Top

This document explains how to Backup and Rollback process. The preface for Backup and Rollback contains the following sections:

  • Backup
  • Backup File Types
  • Access To Backups
  • Rollback
  • Backup Check

 

Obtaining DocumentationTo Top

Tegsoft documentation and additional literature are available on Tegsoft Knowledge Base. This section explains the product documentation resources that Tegsoft offers.

Tegsoft Knowledge Base

You can access the most current Tegsoft documentation at this URL:

https://tegsoft.com/knowledge-base/

 

PrerequisitesTo Top

  • You must have basic knowledge of networking
  • You must have basic knowledge of SSH connection
  • You must have basic skills of Linux Command Line Interface

 

In the following, information and methods about the copying, troubleshooting and disaster scenarios of Tegsoft system under the titles of backup, backup types, access to backups and roleback are given below. The content specified here is managed and used by the Server Maintenance application.

 

BackupTo Top

Backup can be defined as database backup. Backup stores necessary datas for working system efficiently.These files are media files(Announcement and Hold musics), history datas(CDR records, Agent action history) and current datas(contact records, order informations). If a problem occurs on system, system can be rollback from these files. The backup process can be performed at any time or automatically by the system.

 

Automatic BackupTo Top

From Tegsoft, to set backup time, follow this PBX Managemet–>Server Settings. In Archive/Backup group Backup Time (hh: mm): 02:30) is set as a default. This backup time can be changed by the user. Tegsoft backups automatically every day at the specified Backup time.

 

Real Time BackupTo Top

Real time backup is the storage of all data processed on the system as a recoverable file until the following command runs.

For Real Time Backup:

  • To connect to server, SSH protocol should be used via port 2222
  • After you connected the server run this command below
./tegsoft_BackupDB.sh

 

Backup File TypesTo Top

There are 2 types of backup file in Tegsoft.

  • The Backup file that contains all datas.
  • The Backup file that contains configuration datas.

 

The Backup File That Contains All DatasTo Top

Backup files that contais all datas are created in DATE-SERVER MAC ADDRESS.tgz format. That backups contains everything done on the system.

 

The Backup File That Contains Configuration DatasTo Top

Backup files that contais configuration datas are created in DATE-V2-SERVER MAC ADDRESS.tgz format. These backups contain the data required for the operation of the system (customer representative, extension definitions, user definitions, etc.), media files (IVR announcements, hold music, etc.).

 

Access To BackupsTo Top

Backups are divided into 2 different groups in Tegsoft. These are:

  1. Local Backups
  2. Remote Bacups

 

Local BackupsTo Top

Tegsoft server contains all the backups of the system for the last 7 days on its own disk.

These backups can be accessed with this 2 ways:

  • From the backup folder via Windows share,
  • When connecting to the server with SSH, run the command
ls -lrth /home/tobe/backup/
          on the command line,
 

Example backup file name: 20141020-21:21:21:41:41:41.tgz

 

Remote BackupsTo Top

Tegsoft server contains the last 7 days of the system’s configuration backups on its own disk and on the remote Tegsoft Backup servers.

These backups on disk can be accessed with this 2 ways:

  • From the backup folder via Windows share,
  • When connecting to the server with SSH, run the command
ls -lrth /home/tobe/backup/*-V2-*.tgz 
          on the command line,
 

Example backup file name: 20141020-V2-21:21:21:41:41:41.tgz.

Access to backups under Tegsoft Backup Servers is described in detail in Server Maintenance step 1.2.2 under Remote Backups.

 

RollbackTo Top

Rollback is a process that can be performed in case of database damage or at any time via Tegsoft. If database was damaged, the system opens the Recovery Operations screen automatically when try to login Tegsoft.

There are two procedures to rollback below.

  1. Rollback procedure in case of database damaged
  2. Rollback procedure of database that is not damaged

 

Rollback Procedure In Case Of Database DamagedTo Top
  1. Open a browser on your operation system (Internet Explorer,Firefox,Opera,Chrome etc).
  2. Enter the IP address of Tegsoft system to the address bar.
  3. The user login screen will not appear because the database is damaged. Instead of login screen, the Recovery Operations application will be opened automatically to restore data.
  4. The Server Unit Id, MAC Address and TegsoftPBX_Base licence key are entered in the corresponding fields.
  5. After filling all fields, then click the ENTER button. If the information you entered is correct, screens will be appear to perform operations.
  6. If you want to restore from local backups, then move to step 9.
  7. Click the REFRESH button under Remote Backups field. After that, the backups in Tegsoft Backups Servers are listed.
  8. Choose the backup that will restore from the backups listed under Remote Backups field. Then, click the DOWNLOAD button to download the backup in Tegsoft Backup Servers to local disk. The backup you have just downloaded will be under Local Backups.
  9. Click the REFRESH button under Local Backups field to list local backups.
  10. Choose the backup you want to restore from the backups listed.
  11. After choose the backup, click the Recover with Backup button.
  12. After the operation is started, you will see the status messages near Recover with Backup button.
  13. When you see the “Recovery done. Restarting WEB Service” message in status message, refresh the browser after 2 minutes.
  14. Login page to Tegsoft System will be open.
  15. Restore operation is done successfully.

 

Rollback Procedure Of Database That Is Not DamagedTo Top
  1. Open a browser on your operation system (Internet Explorer,Firefox,Opera,Chrome etc).
  2. Enter the IP address of Tegsoft system to the address bar.
  3. Login page to Tegsoft System will be open.
  4. Fill the username and password fields correctly and click the login button.
  5. Open the System Management menu.
  6. Click the Server Maintenance app.
  7. Open the Recovery Operations tab.
  8. The Server Unit Id, MAC Address and TegsoftPBX_Base licence key are entered in the corresponding fields.
  9. After filling all fields, then click the ENTER button. If the information you entered is correct, screens will be appear to perform operations.
  10. If you want to restore from local backups, then move to step 13.
  11. Click the REFRESH button under Remote Backups field. After that, the backups in Tegsoft Backups Servers are listed.
  12. Choose the backup that will restore from the backups listed under Remote Backups field. Then, click the DOWNLOAD button to download the backup in Tegsoft Backup Servers to local disk. The backup you have just downloaded will be under Local Backups.
  13. Click the REFRESH button under Local Backups field to list local backups.
  14. Choose the backup you want to restore from the backups listed.
  15. After choose the backup, click the Recover with Backup button.
  16. After the operation is started, you will see the status messages near Recover with Backup button.
  17. When you see the “Recovery done. Restarting WEB Service” message in status message, refresh the browser after 2 minutes.
  18. Login page to Tegsoft System will be open.
  19. Restore operation is done successfully.

 

Backup CheckTo Top

Backup files should be checked regularly. Control procedure as follow.

 

Local Backup CheckTo Top

\ TEGSOFT_IP \ backup that contains daily backup files should be accessible to windows share for local backup check.

 

Remote Backup CheckTo Top

A software checks the backups that sent to the data center every morning at 08:00. After this checking, Alarm mail is created for the backups that have not reached to data center. The Alarm means that there is no backup in the data center for the server related and in case of a failure, restore operation can not be performed from data center. Having backup files at data center provides crucial advantages about restore scenario in the event of disaster level failure.

 

Access CheckTo Top

Apply these control steps below to access backups to data center correctly to provide technical checks.

 

DNS CheckTo Top

The www.tegsoft.com name should be resolved to the IP address correctly.

run this command

host www.tegsoft.com

If the result of command is “www.tegsoft.com has address 37.9.205.227”, DNS Check result is successful. So, move to second check topic.

If the result of command is “Host www.tegsoft.com not found: 3(NXDOMAIN)”, “NO DNS SERVER FOUND”, “Time out” or similar error message, there is error on DNS setting.

The local DNS Server value must be fixed. The correct value for DNS Value in “Server Settings” from Tegsoft web screen should be entered.

DNS settings must be adjusted until the DNS Check result is successful.

 

HTTP Access CheckTo Top

If the download of ping.html with wget command is successful as follows, the HTTP access check result is successful.

wget www.tegsoft.com/ping.html

–2014-10-28 19:59:14– https://www.tegsoft.com/ping.html Resolving www.tegsoft.com… 37.9.205.227 Connecting to www.tegsoft.com|37.9.205.227|:80… connected. HTTP request sent, awaiting response… 200 OK Length: 912 [text/html] Saving to: ping.html' 100%[==============================================================================================================>] 912 --.-K/s in 0s 2014-10-28 19:59:15 (79,1 MB/s) -ping.html’ saved [912/912]

Otherwise, network access should be checked.

 

SCP Access CheckTo Top
echo TEST > a.txt

scp -i /root/.ssh/customer -P 2222 -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no a.txt [email protected]:/home/customer/Warning: Identity file /root/.ssh 

If the command output results in file transfer as follows, the SCP Access control result is SUCCESSFUL.

Warning: Permanently added 'www.tegsoft.com,37.9.205.227' (RSA) to the list of known hosts. a.txt 100% 1 0.0KB/s 00:00

If the command output is like “file transfer didn’t end up”, “access error” etc, SCP access check result is unsuccessful. Communication infrastructure should be checked.

Warning: Identity file /root/.ssh/customer not accessible: No such file or directory. ssh: connect to host www.tegsoft.com port 2222: No route to host lost connection