ENA TrustBackup

Getting Started

How ENA TrustBackup works

ENA TrustBackup is a comprehensive file backup solution with cloud storage that uses a "forever forward" backup methodology. The first time a backup job is executed for selected files, all data in the files will be backed up. In subsequent job runs, ENA TrustBackup does block-level file copying, backing up only the parts of a file that have changed. Backup data is versioned with a time stamp, each appearing as a full backup. When selecting data for restoration, you can choose from any backup version and, at the desired level of granularity–the entire content of a folder or individual files.

Prior to backing up files from a computer or server, you are first required to download an ENA TrustBackup Agent to the machine. The computers and servers onto which you install the ENA TrustBackup Agent are referred to as clients.

Once the ENA TrustBackup Agent is in place, you create executable backup jobs. Each backup job will contain parameters that define:

• What files will be backed up.
• When and how often backup jobs will run.
• How long the files will be retained.

When working with a number of similar devices, users may find it efficient to create multiple backup jobs at once, applying the same set of parameters to other agents. This is done by using the Duplicate backup job for other agents section when you create a job.

You can create tags and apply them to agents to make it easy to sort and apply an action to a group of agents.

Log in to ENA TrustBackup

1. Point your browser to my.ena.com.
2. Enter your my.ena.com credentials.
3. Select ENA TrustBackup.

Dashboard

The Dashboard presents an overview of Current account details regarding agents and storage quotas, Backup job details, and Events for the last 14 days. It also provides links to Download the agent and copy the Entitlement key.

Backup Jobs

Backup jobs are sessions in which a backup job is run on an agent. The Backup jobs page gives you a table view of all backup jobs which are scheduled or ready to be manually run.

Working with Backup Jobs

Choose Job Data to View

You can use the drop-down at the top of the page to filter the number of jobs that appear in the table.

You can filter by:

• Agent name.
• Backup job name.
• Agent status. 
• Next scheduled.

Jobs Status

The following are the Job status types::

You see options for working with jobs in the Actions column.

Run Now

Click Run now to start a job manually.

Stop

When you click Run now to start a job, the button toggles to Stop now. Click Stop now to stop the job.

Edit

Click Edit change backup job parameters.

Duplicate

Click duplicate in order to clone backup jobs for other agents.

Events

Click here to see past events for this backup job.

Repair

To resolve sync errors on an agent:

1. Go to the Jobs page.
2. From the Actions column.
3. Click Repair.
4. Click OK to confirm.

Delete

Removes the selected backup job.

Create a New Backup Job

1. Select Backup jobs from the top menu.
2. Click Create job.
3. Type the desired backup job into the Name field.
4. Select an Agent to add to this backup set from the Agent drop-down. You may use the Tag drop-down to filter the list of Agents.
5. Once an Agent is selected, you will see all the available folders and files on that machine in the Source data window. You can Select folders or files you want to be backed up from the file explorer or Enter path manually.
6. You have the option to apply Filters to the data being backed up. For more information about Filters, click here.
7. Enter the Schedule parameters for this backup job.
8. Enter the Retention parameters for this backup job.
9. If you would like to duplicate this Backup job for other agents, select the agents and click Create. This action will create a new backup job for each agent selected. You can narrow the list of agents you see in Select other agents by using the Tag drop-down or by typing an agent name into the Filter field. This is helpful when you are managing a system with a large number of agents.
10. Click Create.

Agents

An agent is ENA TrustBackup software installed on a client.

Install Agents

You must install an ENA TrustBackup Agent on every client for which you would like to use ENA TrustBackup.

Install an agent on Mac OS or Windows OS

1. Scroll to the Download agent installer section of the Dashboard.
2. Copy your Entitlement key. You will need it during the agent installation process.
3. Select the operating system of the machine onto which you are installing the agent.
4. Open the downloaded TrustBackupAgent.msi file.
5. Click Next and follow the prompts.

Install an Agent on Linux OS

The client computer must be connected to an ENA network to complete the installation process.

1. Locate your Entitlement key on the Dashboard. You will need this during the installation.
2. Click Centos 7 Linux (x86_64).
3. Run the following commands to install:
   sudo curl -o /etc/yum.repos.d/enatrustbackup.repo
https://nsvltn.trustvault.ena.com/trust-backup-
agent/enatrustbackup.repo
sudo yum -y install enatrustbackup
sudo install_enatrustbackup.sh
4. You will receive the following output:
   Created symlink from /etc/systemd/system/multi-user.target.wants/enatrustbackup.service to /usr/lib/systemd/system/enatrustbackup.service.
5. At prompts:
   Enter a new web UI password: [Enter your password and record it.]
   Enter a backup passphrase:[Enter a backup passphrase and record it.]
   Alert

   Loss of your backup passphrase will result in loss of access to your data.

   Enable verbose logging mode? (y/n): y
Enter a license key: [Enter Entitlement key found on your ENA Trust Backup Dashboard]

6. You will receive the following output:
   Created symlink from /etc/systemd/system/multi-user.target.wants/enatrustbackup-agent.service to /usr/lib/systemd/system/enatrustbackup-agent.service.

Confirm Successful Agent Install

You can confirm the ENA TrustBackup agent is successfully installed and working on the Agents page.

Working with Agents

On the Agents page, you see a summary table for all agents and an Actions column.

Choose Agent Data to View

By default, you see data for all agents in the table. You can filter the agents shown by OS, Status, Tag, or Version.

Edit Agent Name

When you install an ENA TrustBackup agent on a client, it uses the Hostname as the agent name by default. You can edit agent names to help you easily recognize and work with them.

To edit an ENA TrustBackup agent name:

1. On the Agents page, click the pencil icon to the right of the Agent name you would like to edit.
2. Enter the new name.
3. Click the check mark.

Check Agent Version

ENA TrustBackup will push updates to clients periodically. You see the current Version on the Agents page.

Check Date Added

There are times you may want to see the date an agent was added to ENA TrustBackup. Date Added displays the install date of the agent.

Check Agent Status

When an agent is connected to the network and available, its status shows as Ready in the Status column on the Agents page. If the agent is not connected to the network and is available , its status shows as Unavailable. This could be caused by the client being powered off or disconnected from the network. Firewall restrictions may also impact agent availability.

If you do not see an agent in the list when creating a new backup job or adding agents to a backup job, check its status.

Agent status types are:

Check Next Scheduled Backup Run

There are times you may want to see the Next scheduled backup run for an agent.

Check Bandwidth Policy

There are times you may want to see the assigned Bandwidth policy for an agent.

Actions Column

There are several Actions available for agents. 

Pause Agent

There are times you may want to pause an agent from being backed up, for example, during school testing periods. To pause an agent, click Pause in the Actions column for that agent, and select the Pause duration from the drop-down.

If you choose to pause the agent Until resumed, click Resume in the Actions column to resume normal backups for that agent.

View Details

There are times you may want to view details about an individual agent. The View Details option enables you to view multiple dimensions of the agent.

1. Overview with Agent version, Job schedule data, and the Last 7 days events.
2. Backup jobs with information about all Backup jobs scheduled to run against the agent.
3. Events with details about all recorded events affecting the agent.

Reconcile Agent

There are times when the files on the agent are different from those in the database.

ENA TrustBackup assumes the files in the database are correct. To reconcile differences between the agent and database files:

1. On the Agents page, click Reconcile next to the agent.
2. Review differences and click Reconcile.

Delete Agent

To delete an agent, click Delete in the Actions column and click OK to confirm.

Restore

Files can be restored to the Same agent or Other Agent .

Restore to Same Agent

1. Select Restore from the menu.
2. Select Same agent.
3. Select agent from which you would like to restore files.
4. Select backup job and Select version from drop-downs.
5. Select folders or files from the file explorer.

6. Click Next.
7. Select location to specify the location to which you would like to restore the files. 
   • Original restores the file to the original agent in the original location.
   • Pick location opens up a file explorer you use to select a different location on the original agent.
8. Select the Restore mode you will use.
   • Overwrite will replace files of the same name on the client with the files being restored.
   • Save different versions with timestamp in the file name adds a timestamp to the file or folder name during restore. It does not overwrite files of the same name on the client with the files being restored.
9. Select Permissions.
   • Files and folders are restored with the same permission settings they had when they were backed up.
10. Verify your selections. Click Restore, then click OK to confirm.

Restore to Other Agent

1. Select Restore from the menu and select Other agent.
2. Select source agent from drop-downs.
3. Enter Source agent passphrase.

4. Select destination agent from drop-down.
5. Click Next.
6. Select version from drop-down.
7. Select folders or files you would like to restore.
8. Click Next.
9. Select location to specify the location to which you would like to restore the files.
   • Original restores the file to the original agent in the original location.
   • Pick location opens up a file explorer you use to select a different location on the original agent.
10. Select the Restore mode you will use:
    • Overwrite will replace files of the same name on the client with the files being restored.
    • Save different versions with timestamp in file name adds a timestamp to the file or folder name during restore. It does not overwrite files of the same name on the client with the files being restored.
11. Select Permissions. Files and folders are restored with the same permission settings they had when they were backed up.
12. Verify your selections. Click Restore then click OK to confirm.

Event History

The Event History page gives you a consolidated view of past jobs.

Choose Event Data to View

You can use the drop-downs at the top to filter the Event history. Once you select your filters, click Apply. You can filter the event list by:

• Agent name 
• Backup job 
• Event type 
• Time interval

View details

Click View details for a granular view into data for the event.

Tags

Create a New Tag

Tags are a way to group and filter agents. To create a tag:

1. Select Tags from the menu.
2. Click on Create tag.
3. Enter the tag Name (required) and a Description (optional).
4. To tag available agents here, click the check box next to an agent.
5. Click Create.

Tag Agents

1. On the Tags page, click Edit next to the tag to which you would like to add an agent.
2. Click the checkbox next to the agent you would like to tag.
3. Click Update.

Managing Bandwidth Used by ENA TrustBackup

You can set limits on the amount of bandwidth ENA TrustBackup uses for uploads and downloads at the global level and/or the agent level. When working with bandwidth at the agent level, you will create a Bandwidth policy.

Set Global Maximum Download and Upload Speeds

To set Maximum download speed for all agents:

1. Go to Other settings on the Settings page.
2. In the Maximum download speed drop-down, select the unit of measure you would like to use.
3. Enter a quantity.
4. Click Apply.

To set a Maximum upload speed for all agents:

1. Go to Other settings on the Settings page.
2. In the Maximum upload speed drop-down, select the unit of measure you would like to use.
3. Enter a quantity.
4. Click Apply.

Create a Bandwidth Policy and Assign Agents To It

1. Select Bandwidth Policies.
2. Click Create policy.
3. Enter policy Name.
4. In the Maximum upload speed field, input the desired maximum upload speed and select the unit of measurement from the drop-down.
5. In the Maximum download speed field, input the desired maximum download speed and select the unit of measurement from the drop-down.
6. Add a Description of the policy (optional).
7. Select Agents to which you would like to apply the bandwidth policy.
8. Click Create.

Managing Bandwidth Policies

Edit

To edit a Bandwidth Policy:

1. Go to Bandwidth Policies.
2. Under Available Policies, click Edit.
3. Under Update policy Default, select the name, Maximum upload speed, Maximum download speed, or Description fields to edit.
4. Click Update.

Delete

To delete a Bandwidth Policy:

1. Go to Bandwidth Policies.
2. Find the policy you would like to remove and click Delete.
3. Click OK to confirm.

Working with SQL Server Database Backups

Before you start

ENA TrustBackup can detect a SQL Server database instance running on a host server, providing the option to use TrustBackup for the primary or secondary SQL Server database backups.

TrustBackup uses a separate backup engine to back up and restore SQL Server databases and their .mdf and .ldf components.

Guidelines and Requirements

Use TrustBackup As a Secondary SQL Server Database Backup

TrustBackup makes an excellent companion to native SQL Server Database backup.

TrustBackup can be used to backup .bak files files to cloud storage.

Alternatively, customers can use TrustBackup to create a secondary set of SQL Server database backups using TrustBackup's database backup method. Either way, your database backups are stored safely offsite in ENA's cloud storage repository.

Create Standalone Database Backups

SQL Server database backup should be run as a standalone job.

Do not group other data or system files with your database backup. Create separate backup jobs as desired for other file types.

SQL Server VSS Writer required

SQL Server VSS Writer is required for SQL Server database backups since the running database engine puts a lock on the underlying database files. The SQL Server VSS Writer service enables these locked files to be backed up while the database engine is running.

Creating a SQL Server Database Backup

Verify SQL Server VSS Writer is Running

When creating a job to backup a SQL Server database in ENA TrustBackup, it is important to verify that both the SQL Server database instance and the SQL Server VSS Writer are active on your source machine. SQL Server VSS Writer service enables TrustBackup to access and copy these files while they are locked and in use.

Suppose SQL Server VSS Writer is not actively running at the time you of attempt to create a new SQL Backup job. In that case, TrustBackup will display the following warning message: "You must enable the SQL Server VSS Writer service in order to backup SQL Databases while the SQL Server Engine is running."

To enable the SQL Server VSS Writer service:

1. Go to the services console on the source machine where SQL Server is running.
2. Right-click on the SQL Server VSS Writer service.
3. Choose Start.

Create a Backup Job for your SQL Server database

Upon selecting the source machine in the Agent drop-down, the Source Data will populate with a list of folders and files.

Never attempt to backup non-database files or folders while also backing up SQL Server databases.

Execute a SQL Server Database Backup

When your new backup job is run, ENA TrustBackup will automatically back up all the files related to your selected SQL Server databases. You will be able to verify the success of the backup job execution and the number of files backed up by checking the Event history.

Restoring a SQL Server Database

Stop SQL Server

When restoring SQL Server databases, first stop the SQL Server engine service to unlock the underlying database files. Attempting to restore SQL databases from TrustBackup while the SQL Server engine service is running will result in an error condition, which can be viewed in the Event history.

To stop the SQL Server database service on the target machine:

1. Right-click on the main SQL Server engine service. The service will be called "SQL Server [instance name]."
2. Choose Stop.

Restore a SQL Server Database from Backup

To restore SQL Server databases from a backup job, navigate to the Restore function in TrustCompute and select the desired backup.

1. Select Restore from the menu.
2. Select Agent for the server where your SQL Server instances are running.
3. Select backup job which contains your SQL Server database files to be restored.
4. Select version.
5. In the folders and files list on the screen, choose the specific database files that you want to restore, usually an .mdf and an .ldf file for each database.
6. Select location to which you would like files to be restored. This is usually the Original location.
7. Select Restore mode, which will typically be Overwrite.
8. Restore read/write permissions as appropriate.
9. Click the Restore button at the bottom of the screen to initiate the restore job. Restore jobs and status can be viewed on the Jobs page as they execute.

It may take several minutes for the restore to complete.

TrustBackup will automatically restore all files backed up in relation to the restored database. Use the Event History to verify that the restore has completed successfully.

Restart SQL Server

When the restore has been completed, return to the services console on the target machine and restart the SQL Server engine service.

1. Right-click on the SQL Server engine service.
2. Choose Start.

Best practices

Backing up SQL Server databases in TrustBackup

• The TrustBackup agent must be installed on each SQL Server host server in order to define backup jobs to backup SQL Server databases.
• Ensure that SQL Server is not being backed up by more than one backup solution. Using multiple backup solutions can cause issues with Transaction Log backups and could result in data corruption. It is best to disable backup jobs in SQL Server for those databases backed up with TrustBackup. Alternatively, you could define your database backup jobs in TrustBackup to only backup the .bak backup files from the file system previously created by a SQL Server backup utility.
• SQL Server Backups use the SQL Server Volume Shadow Copy Service (VSS), so be sure that the SQL Server VSS Writer service remains running on the host server so that TrustBackup can copy the locked database files.
• Do not attempt to back up databases with other folders or files. Back up databases separately from other data.
• Perform test restorations of backed-up databases periodically to ensure smooth execution of your disaster recovery plan when needed.
• Verify backup jobs are complete successfully by checking Event History periodically. 
• Create a series of SQL database backup jobs to execute nightly and weekly.

Restoring SQL Server databases from TrustBackup

With ENA TrustBackup, you can:

• Restore a database to any available SQL Server with the same or newer version of SQL Server installed.
• Rename a database and restore it to any alternate file path.
• Optionally define a backup job which will backup up previously created SQL Server backup files (.bak files) that were created by scheduled SQL Server backup jobs. Then you can use SQL Server Management Studio to restore your databases from these .bak files.

Microsoft SQL Server Terminology

Microsoft SQL File Types

Filters

By default, all files in folders you select are included in a backup job. You can use filters to include or exclude files and folders from your backup job.

Filters-basic

Using the basic filtering tool, you can exclude:

• Files larger than a specific size. 
• Hidden files.
• System files. 
• Temporary files.

Filters-advanced

You have the option to create custom filters using Filters-advanced.

ENA TrustBackup's filter engine processes folders first then files. The reason for this order is performance. If a folder is excluded from a backup, the files inside that folder are not processed.

When filter rules have been defined, the first folder is taken, and the filter rules are processed one by one. The first rule that matches is applied, and the following rules are not processed anymore. For instance, if the first rule excludes a folder, then this folder and all files within will be excluded from the backup, even if the following rules include this folder or its files.

It is recommended to write folder rules first and file rules next. That way, rules are written in the same order in which they will be applied when ENA TrustBackup processes them.

Once you choose Exlude or Include from the drop-down, define the rules for the filter. 

Syntax parameters include:

• ? matches any single character.
• * specifies none or multiple characters.
• Rules can be specified as regular expressions. In this case, put the regular expression (using
• .NET syntax) into hard brackets [].
• Folder names always end with a slash / on Linux or Mac and a backslash \ on Windows. For instance, "log" is a file, "log/" is a folder.

Common use cases

• Exclude specific sub-folders.

  You want to backup all photos on your NAS (Network-attached storage). Your photos are stored in hundreds of folders and each of those folders contains a sub-folder called "@eaDir" that contains thumbnails in different sizes that your NAS uses for a web interface. You want to backup your photos but not the thumbnails. In this example, you just exclude all thumbnail folders and, thus their content. The rule is: -*/@eaDir/. Don't forget the trailing slash that defines @eaDir as a folder.

• Exclude specific files.

  You store your photos and movies in the same folders. For some reason, you do not want to include the movies into your backup. You could define a rule like -*.mov or -*.avi.

• Include specific files only

  You have a folder structure that contains a lot of photos and movies from your camera. For some reason you only want to include the photos to your backup. The rule for your backup is +*.jpg +*.jpeg. As there are rules in this filter, ENA TrustBackup automatically excludes all other files.

• Include some files, exclude others.

  Now let's define a filter that does both of the above. First it excludes @eaDir specifying -*/@eaDir/. Then it includes only JPG files specifying +*.jpg. The problem here is, that ENA TrustBackup includes all files and folders per default. This means that e.g. /photos/movie.avi will also be part of the backup. To make the including rule effective an additional rule is required that excludes all files that do not match any of the current rules. The filter must say "exclude this, exclude that, include this but nothing else". The best rule for "but nothing else" is a regular expression that excludes all files. On Windows the rule is -.*[^\\]. The rule says "exclude everything that is not a folder". The final filter then is -*/@eaDir/ +*.jpg +*.jpeg -.*[^/]. ENA TrustBackup will process all folders but @eaDir/ and it will include JPG and JPEG files but exclude all other files. A job is the running of a backup set on an agent.

Settings

Notifications

Go to the Notifications area of the Settings page to change, add to, or delete email addresses where notifications will be sent when system issues occur.

Other settings

See Set Global Maximum Download and Upload Speeds.

Release Notes

What's new in v2.1.0?

V2.1.0 Adds new messaging for users, an ENA Support dashboard for improved condition monitoring, and bug fixes.

New Features

• Dashboard flag for backup agents that are "Unreachable." 
• Notification for user-initiated actions when an agent is not available. 
• Status dashboard for ENA Support.

Bug Fixes

• Details are not updated when ENA Administrators change the community. 
• Some backup jobs actions should be disabled if agent status is "Unreachable."
• Incorrect number of used agents displayed under specific conditions.
• Disable the Repair link for backup jobs that have never run.

What's New in Version 2.0.0?

The release of ENA TrustBackup 2.0.0 delivers significant changes to how users work with backups.

• Backup Sets have been eliminated and replaced with Backup Jobs. 
• Page navigation has been streamlined.
• New detail and admin actions have been added to the Backup jobs and Agents pages. 
• Help Center documentation updates.

Feature enhancements

• Backup Sets have been eliminated and replaced with individual Backup Jobs. This removes a difficulty TrustBackup users have experienced when attempting to manage existing Backup Sets, especially in situations where file structures have changed on one or more devices associated with a Backup Set. Instead of the former "One Backup Set to many Agents" relationship, users will instead work within a "One Backup Job to one Agent" relationship. The efficiency enjoyed by administrators who manage many devices will remain, however, in that they can now duplicate Backup Jobs for one or more agents at a time.
• ENA TrustBackup users will note that we are continuing to improve our user interface with streamlined navigation. Gone is the "hamburger" icon in the upper left corner. Users now navigate using visible page headers across the top of the screen.
• New detail is available for users on the Backup Jobs page, including Last Modified. Additional actions can also be taken directly from the Backup jobs page, including Edit and Duplicate.
• New detail is available for users on the Agent page, including Version. Additional actions can now be taken directly from the Agents page, including View Details.
• Help Center documentation has been refreshed to highlight new TrustBackup features. Users will also find useful tips for simple SQL backup.

What's New in Version 1.4.0?

The release of ENA TrustBackup 1.4.0 delivers improved backup performance.

Feature enhancements

• Enable multi-threading for improved performance during backup processing. 
• Show Last Modified time stamp for Backup Sets.

Fixes

• Browser freezes during Backup Set creation.

What's New in Version 1.3.0?

The release of ENA TrustBackup 1.3.0 delivers enhancements to the administrative interface that provide administrators with even more control over their backups, restores, and agents.

Feature enhancements

• The Restore function has become more prominent with its own, navigable page. Losing data is stressful but restoring it just got a little easier.
• Restore to Other Agent now requires the administrator to enter their passphrase. This extra layer of security ensures backup data stays private and backup administrators stay in control of where data is restored.
• A progress bar will now be displayed during the Restore process.
• Backup jobs in progress can now be stopped via a Stop Now option on the Jobs page.
• A Repair feature has been added for situations where data stored on the local agent cannot be found or is corrupted. Repair will recreate local agent data from ENA TrustBackup's primary database.
• A Reconcile feature has been added for local agents that have become out of sync with ENA Trustbackup's primary database. Reconcile provides administrators with the option to re- synchronize local agent data with ENA TrustBackup's primary database.
• A download link is now available for installing ENA TrustBackup agents on Linux CentOS operating systems in addition to Windows and macOS.

Fixes

• Improve event handling for throttle proxy. 
• Email notification bit set to "Off."
• Agent service is not auto-restarted after Windows restart (timing issue).
• Cannot update Backup Set if the old agent is not available.
• Events for Backup Set with MacOS agent associated are not displayed. 
• Browser freezes when creating a backup set.
• Unexpected error when running a backup.