ENA TrustBackup

Getting Started

How ENA TrustBackup works

ENA TrustBackup is a comprehensive file backup solution with cloud storage. It is a forever forward incremental backup solution. All files in a backup set are copied during the first job. In subsequent jobs, ENA TrustBackup does block-level file copying, backing up only the parts of a file that have changed. You can of course, restore a full backup set from any job run at any point in time.

To back up files from a computer or server to ENA TrustBackup, you first 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.

You create backup sets to define:

  • What files will be backed up
  • When and how often they will be backed up
  • How long the files will be retained

You add agents to a backup set. One or many agents may be added to a backup set. An agent may be added to more than one backup set.

The session during which a backup set is run on an agent is 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.

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. ENA TrustBackup currently provides automated agent installation for Mac and Windows operating systems.

Alert: During the agent install process, you create a passphrase. Loss of this passphrase will render all encrypted data nonrecoverable. In order to ensure security and data privacy, ENA TrustBackup encrypts all data before transmitting it to the ENA Cloud. ENA TrustBackup employs a TNO (trust-no-one) security model and does not store your passphrase outside of your local system. Therefore, ENA is not able to recover a lost passphrase. Please store this passphrase to ensure data recovery when needed.

Install agent on Mac 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 install 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.

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 list of agents shown by Tag or Find agent.

Edit agent name

When you install an ENA TrustBackup agent on a client, it uses the Host name as the agent name by default. You can edit agent names to help you more 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 status

If an agent is connected to the network and available for backup, its status shows as Ready in the Status column on the Agents page. If the agent is not connected to the network and available for backup, its status shows as Unavailable. This could be caused by the client being powered off or disconnected from the network. Agent availability may also be impacted by your firewall settings.

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

Agent status types are:

Status Description
Paused Agent has been manually paused
Ready Agent is ready for backup or restore
Running Agent is running a backup or restore
Unavailable

Agent is unavailable for backup or restore. This could be caused by the client being powered off or disconnected from the network. Agent availability may also be impacted by your firewall settings.

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.

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.

Backup Sets

A backup set is a list of rules which define:

  • What files you want to backup
  • When and how often you want to back them up
  • The duration of time for which they are kept

Once a backup set is created, multiple agents may be added to it.

Create a New Backup Set

In this example, we want to back up the attendance records for the elementary and the middle/high school every day at 4 pm, M-F. These records are kept on each school's main office computer in a folder named Attendance. We want to keep these files for 10 years.

  1. Select Backup Sets from the menu.
  2. Click Create new backup set.
  3. Type the name into the Name field. In this example, we'll use Attendance.
  4. The next step is to select an Agent to add to this backup set. If we want to add other agents to this Backup set later, this agent will serve as the model. In this example, we choose elementary office main, which has the Attendance folder we want to include in this backup set.
  5. In this example, we only have three available agents, so it is very easy to find the one we want to back up. If you have a large number of agents in your system, you can filter the list of agents you see in the list by Tag. This step is optional and is designed to streamline the process of applying backup sets in a system with a large number of agents. To learn more about tags, click here.
  6. Once you select an agent, you see all the available files on that machine in the Source window. You can Select folders or files you want to be backed up from the file explorer or Enter path manually.
  7. You have the option to apply Filters to the data being backed up. For more information about Filters, click here.
  8. Enter the Schedule parameters for this backup set. In this example, we want to back the Attendance folder up every weekday at 4:00 pm.
  9. To use a different example, if we want to schedule a backup set to run every Friday at 7:00pm, we choose Every week, and then select Friday from Allowed days.

  10. Enter the Retention parameters for this backup set. We want to retain these files for 10 years.
  11. If you would like to add additional agents to this backup set, select them under Select other agents. In our example, we will add the middle/high school office main agent to this Backup set. When you select another agent, the system will check and make sure the files or folders selected in the Backup set exist on that client. If they do, you see Valid in the Usable column.

    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. In this example, we only have two additional agents, so we did not use this feature.

  12. If you attempt to add an agent installed on a client that does not have the files or folders you have included in your backup set, you see a warning.

  13. Click Create.

Working with Backup Sets

You see options for working with backup sets in the Actions column.

Run now

Click here to manually run the job.

Jobs

Opens up the Jobs panel below the Backup sets panel.

Edit

To edit a backup set:

  1. Go to the Backup sets page.
  2. Click Edit under the Actions column for the backup set you would like to edit.

Delete

Deletes the backup set.

Restore

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

Restore to Same Agent

  1. Select Restore from the menu.
  2. In the Same agent panel, Select agent from which you would like to restore files.
  3. Select backup set and Select version from drop-downs.
  4. Select folders or files from the file explorer.
  5. Note: In the Select version drop down, you see only jobs in which files or folders have changed.

  6. 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.
  7. 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.
  8. Select Permissions.
    • Files and folders are restored with the same permission settings they had when they were backed up.
  9. 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 and Select backup set from drop-downs.
  3. Enter Source agent passphrase.
  4. Note: This is the passphrase created during the agent installation of the source device. ENA TrustBackup employs a TNO (trust-no-one) security model and does not store your passphrase outside of your local system. ENA is not able to recover a lost passphrase. Please store this passphrase to ensure data recovery when needed.

  5. Select destination agent from drop-down.
  6. Click Use.
  7. Select version from drop-down.
  8. Select folders or files you would like to restore.
  9. Select location from file explorer or Enter the absolute path in Folder path.
  10. In Restore mode select Overwrite or Save different versions with timestamp in file name.
  11. Select whether or not to Restore read/write permissions.
  12. Click Restore.

Jobs

Jobs are sessions in which a backup set is run on an agent.

The Jobs page gives you a table view of all jobs in all backup sets which are scheduled or ready to be manually run on which agents.

Working with Jobs

Choose job data to view

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

You can filter by:

  • Backup set
  • Agent name
  • Job status
  • Time interval

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

Run now

Click here to manually start a job.

Note: If a job is already running on this agent, this option is grayed out.

Events

Click here to see past events for this backup set and agent.

Repair

Resolves sync errors on the agent. To repair an agent:

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

Stop

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

Delete

Removes that agent from jobs in that backup set.

Jobs Status

Job status types are:

Status Description
Manual Job runs when manually started
Running Job is currently running
Scheduled Job is scheduled to run
Unavailable Job is unavailable to run or restore because the agent is unavailable.

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:

  • Backup set
  • Agent name
  • 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 New 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.

In this example, we create a "main office schools" tag and apply to the agents on both our main office computers at the schools.

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.

Note: If you set a maximum upload or download speed for a specific agent using a Bandwidth Policy, it overrides the global setting for that specific agent.

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. Go to the Bandwidth Policies page.

  2. Under New policy, create a unique policy name.

  3. In the Maximum upload speed field, input the desired maximum upload speed and select the unit of measurement from the drop-down.

  4. In the Maximum download speed field, input the desired maximum download speed and select the unit of measurement from the drop-down.

  5. Add a Description of the policy (optional).

  6. Select Agents to which you would like to apply the bandwidth policy.
  7. Click Create.

    Note: An agent can be assigned to only one bandwidth policy at a time. Once it's assigned to a bandwidth policy, the agent name will no longer appear in the list of selectable agents.

Managing Bandwidth Policies

To edit a Bandwidth Policy:

  1. Go to the Bandwidth Policies page.
  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.

To delete a Bandwidth Policy:

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

Filters

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

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 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 Exlcude 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 expression. 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 including 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.

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.

Note: You must have at least one email address in the Notifications area.

Other settings

See Set Global Maximum Download and Upload Speeds.

Release Notes

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.

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