Help:Restoring Content

From TrainzOnline
(Difference between revisions)
Jump to: navigation, search
(Created page with "With the introduction of Trainz A New Era Service Pack 2, there are a number of changes to how data is backed up and restored. =In-game backups= Backups are now made continuo...")
 
Line 1: Line 1:
With the introduction of Trainz A New Era Service Pack 2, there are a number of changes to how data is backed up and restored.
+
With the introduction of Trainz A New Era Service Pack 2, there are a number of changes to how data is backed up and restored. This article discusses Routes, but the principles apply to sessions and other assets.
  
 
=In-game backups=
 
=In-game backups=
Line 10: Line 10:
 
If you revert changes, the last manually saved version of the route will be loaded.  
 
If you revert changes, the last manually saved version of the route will be loaded.  
  
If you choose "use" then any changes written to disk after the last manual save will also be loaded.
+
If you choose "Use changes" then any changes written to disk after the last manual save will also be loaded. If you want to keep this version of the route, you need to use Save. In other words, if you choose "Use Changes" then exit the route without saving, those changes will be lost.
  
=Backing up your content=
+
Note that if disk activity was occurring at the time the fault occurred, that the relevant parts of the route have a small chance of being corrupted.
We recommend that you backup your local data folder to an external hard drive to ensure that if your main hard drive fails, then your data is protected.
+
After reloading the autosaved changes into Surveyor, and before saving the route, you should check that there is no corruption present.
 +
If you decide that the route is too corrupt to be worth keeping, they should close Surveyor without saving.
 +
This will permanently discard the autosaved changes.
 +
 
 +
=Manual Backup Process=
 +
If your main hard drive fails and you do not have you data saved elsewhere, then you can lose all your data. We therefore recommend that you back up your local data folder to an external hard drive to ensure that your data is protected.
  
 
You can find the location of your local data folder by reading the [[Help:Moving_Content]] guide.
 
You can find the location of your local data folder by reading the [[Help:Moving_Content]] guide.
 +
 +
Windows 10 provides a regular backup utility and there are a variety of other software backup utilities available online to ensure your data is protected.
  
 
=Restoring a Route=
 
=Restoring a Route=
 
There may be a time where a route becomes corrupted and you need to restore a previous version. This process has changed for TANE SP2 and the following guide will assist you in restoring your old version.
 
There may be a time where a route becomes corrupted and you need to restore a previous version. This process has changed for TANE SP2 and the following guide will assist you in restoring your old version.
 +
 +
==What are Backup Files?==
 +
In TANE SP2, your saved data is stored in backup archive files. These files have the suffix .tzarc.
 +
Tzarc files are are readable only by Trainz and cannot be edited by an end user.
  
 
==Finding the Backup Files==
 
==Finding the Backup Files==
Navigate to your local data folder, then click on the \backups folder
+
To find your .tzarc files, navigate to your local data folder (see above for help), then click on the backups folder.
Here you will see up to 7 folders, named with a YY-MM-DD date format (i.e 17-08-07 means 7th August 2017)
+
Here you will see folders named with a YY-MM-DD date format (i.e 17-08-07 means 7th August 2017)
Within each folder are a number of different backup files and folders. Most of these folders are for internal use by TANE.  
+
Within each folder are a number of different backup files and folders. This folder is much like your "Recycle Bin" and contains copies of saved and deleted content.  
 
The important files you will need for your restore process at the .tzarc files.
 
The important files you will need for your restore process at the .tzarc files.
Tzarc files are an archive file that are readable only by Trainz.
 
  
 
==More about .tzarc files==
 
==More about .tzarc files==
 
Each time you use "Save" or "Save As" in Trainz, a new .tzarc file is created.
 
Each time you use "Save" or "Save As" in Trainz, a new .tzarc file is created.
 
These files are saved with the naming format of KUID xxx xxxx.tzarc_xxxxx where xxxx is a random number.
 
These files are saved with the naming format of KUID xxx xxxx.tzarc_xxxxx where xxxx is a random number.
To find your most recent .tzarc file, sort the backups folder by date and then look for the KUID that mathes your route
+
To find your most recent .tzarc file, sort the backups folder by date and then look for the KUID that matches your route.
The next section describes how to use a .tzarc file to restore your route.
+
  
 
==Restoring the Backup Files==
 
==Restoring the Backup Files==
 
If you decide that you need to restore an older version of your route, this is possible using a .tzarc file found in the backups folder.
 
If you decide that you need to restore an older version of your route, this is possible using a .tzarc file found in the backups folder.
 
We suggest that you backup your local data folder prior to attempting any restore operation so that you have original copies of all the files.
 
We suggest that you backup your local data folder prior to attempting any restore operation so that you have original copies of all the files.
 +
Pleae note that these principles apply to sessions and other assets.
  
 
* Find the .tzarc file you wish to restore
 
* Find the .tzarc file you wish to restore
 
* Copy the file from \backups into \editing
 
* Copy the file from \backups into \editing
* Rename the file by removing the "_xxxxx" suffix (i.e. the file should be named inthe format KUID xxx xxxx.tzarc)
+
* Rename the file by removing the "_xxxxx" suffix (i.e. the file should be named in the format KUID xxx xxxx.tzarc)
 
* Open Content Manager and delete the route you wish to replace (make a backup copy of it if you think you may want to use it again)
 
* Open Content Manager and delete the route you wish to replace (make a backup copy of it if you think you may want to use it again)
 
* In Content Manager, click Developer > Rebuild Database
 
* In Content Manager, click Developer > Rebuild Database
 
* This will result in your .tzarc file being read back into the database
 
* This will result in your .tzarc file being read back into the database
* Select the restored asset in Content Manager and right-click > Submit Edits
+
* The restores asset will show as "Open for Edit"
 +
* Select the asset in Content Manager and right-click > Submit Edits
  
 
Your route has now been restored.
 
Your route has now been restored.
 +
 +
==Deleting the Backup Folder==
 +
It is safe to delete anything in the backup folder or the whole folder (a new folder will be created automatically when required).
 +
To avoid moving the deleted files into your Recycle Bin, in Windows you can use Shift + Delete.
 +
Of course, once deleted, the files are then permanently irrecoverable.

Revision as of 14:13, 7 August 2017

With the introduction of Trainz A New Era Service Pack 2, there are a number of changes to how data is backed up and restored. This article discusses Routes, but the principles apply to sessions and other assets.

Contents

In-game backups

Backups are now made continuously while you editing a route and/or session.

If you have a power cut or if the game crashes, it is possible to pick up where you left off by simply reloading the map you were working on.

You will be presented with a choice to either "Use changes" or "Revert changes".

If you revert changes, the last manually saved version of the route will be loaded.

If you choose "Use changes" then any changes written to disk after the last manual save will also be loaded. If you want to keep this version of the route, you need to use Save. In other words, if you choose "Use Changes" then exit the route without saving, those changes will be lost.

Note that if disk activity was occurring at the time the fault occurred, that the relevant parts of the route have a small chance of being corrupted. After reloading the autosaved changes into Surveyor, and before saving the route, you should check that there is no corruption present. If you decide that the route is too corrupt to be worth keeping, they should close Surveyor without saving. This will permanently discard the autosaved changes.

Manual Backup Process

If your main hard drive fails and you do not have you data saved elsewhere, then you can lose all your data. We therefore recommend that you back up your local data folder to an external hard drive to ensure that your data is protected.

You can find the location of your local data folder by reading the Help:Moving_Content guide.

Windows 10 provides a regular backup utility and there are a variety of other software backup utilities available online to ensure your data is protected.

Restoring a Route

There may be a time where a route becomes corrupted and you need to restore a previous version. This process has changed for TANE SP2 and the following guide will assist you in restoring your old version.

What are Backup Files?

In TANE SP2, your saved data is stored in backup archive files. These files have the suffix .tzarc. Tzarc files are are readable only by Trainz and cannot be edited by an end user.

Finding the Backup Files

To find your .tzarc files, navigate to your local data folder (see above for help), then click on the backups folder. Here you will see folders named with a YY-MM-DD date format (i.e 17-08-07 means 7th August 2017) Within each folder are a number of different backup files and folders. This folder is much like your "Recycle Bin" and contains copies of saved and deleted content. The important files you will need for your restore process at the .tzarc files.

More about .tzarc files

Each time you use "Save" or "Save As" in Trainz, a new .tzarc file is created. These files are saved with the naming format of KUID xxx xxxx.tzarc_xxxxx where xxxx is a random number. To find your most recent .tzarc file, sort the backups folder by date and then look for the KUID that matches your route.

Restoring the Backup Files

If you decide that you need to restore an older version of your route, this is possible using a .tzarc file found in the backups folder. We suggest that you backup your local data folder prior to attempting any restore operation so that you have original copies of all the files. Pleae note that these principles apply to sessions and other assets.

  • Find the .tzarc file you wish to restore
  • Copy the file from \backups into \editing
  • Rename the file by removing the "_xxxxx" suffix (i.e. the file should be named in the format KUID xxx xxxx.tzarc)
  • Open Content Manager and delete the route you wish to replace (make a backup copy of it if you think you may want to use it again)
  • In Content Manager, click Developer > Rebuild Database
  • This will result in your .tzarc file being read back into the database
  • The restores asset will show as "Open for Edit"
  • Select the asset in Content Manager and right-click > Submit Edits

Your route has now been restored.

Deleting the Backup Folder

It is safe to delete anything in the backup folder or the whole folder (a new folder will be created automatically when required). To avoid moving the deleted files into your Recycle Bin, in Windows you can use Shift + Delete. Of course, once deleted, the files are then permanently irrecoverable.

Personal tools