Help:Restoring Content

From TrainzOnline
(Difference between revisions)
Jump to: navigation, search
(Add links to How_to_Manage_Backups)
 
(12 intermediate revisions by 3 users not shown)
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. This article discusses Routes, but the principles apply to sessions and other assets.
+
The information in this Wiki Page applies to '''TANE''', '''TRS19''' and '''Trainz Plus'''. While this Help article is focused on backing up and restoring Routes, the principles apply to restoring Sessions or other assets. With the introduction of Trainz A New Era Service Pack 2 (SP2), a number of changes have been introduced regarding how data are backed up and, if needed, restored. Managing backups is discussed in much detail at [[How_to_Manage_Backups]].
  
 
=In-game backups=
 
=In-game backups=
New in SP2, 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 and following the prompts. You will be presented with a choice to either "Use changes" or "Revert changes".
+
New in TANE SP2 and carried through subsequent versions, backups are made continuously while you are editing a route or a session. If you have a power loss or if the game crashes for some reason, it is possible to pick up pretty much where you left off by simply reloading the map you were working on and following the prompts. You will be presented with a choice to either "Use changes" or "Revert changes":
  
If you choose "Revert changes", the last manually saved version of the route will be loaded.
+
*If you choose "<b>Revert Changes</b>", 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 choose "<b>Use Changes</b>" then any changes written to disk after the last manual save will be included.  
  
Note that if you want to keep this version of the route, then after loading and checking everything is ok, you need to use "Save" to permamently save those recent changes. In other words, if you choose "Use Changes" then exit the route without saving, those changes will be lost.
+
Note that if you want to keep this reloaded version of the route, after loading and checking that everything is ok, you need to "Save" to permanently retain those most recent changes. In other words, if you choose "Use Changes" then exit the route without saving, those changes will be lost. Also, if disk activity was occurring at the time the fault occurred, relevant parts of the route have a small chance of being corrupted. After reloading the autosaved changes into Surveyor (i.e.. Use Changes), and before saving the route, you should check that no corruption has occurred. If you decide that the route is too corrupt to keep, close Surveyor without saving to permanently discard the autosaved changes (revert back to the last manually saved version).
 
+
Also, 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 (External Backup)=
 
=Manual Backup Process (External Backup)=
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.
+
<table cellpadding="4" bgcolor=#c1e7e7>
 +
<tr valign="top">
 +
<td>[[file:DotPoint.JPG|link=]]</td>
 +
<td>Your Trainz data files are backed-up to a folder on your hard drive every time you press "Save".</td>
 +
</tr>
 +
</table>
 +
Should your hard drive fail and you do not have your Trainz data saved elsewhere, then you will lose it all. It is highly recommended, therefore, that you back up your local data folder to an external hard drive or cloud server to ensure that your data are recoverable.
  
You can find the location of your local data folder by reading the [[Help:Moving_Content]] guide.
+
In Windows, your data folder is stored by default at the location: C:\Users\<user name>\AppData\Local\N3V Games\.  These may be hidden folders on your system; and "<user name>" is your name on your computer device (seen at login) and not your Trainz user name.  Within the \N3V Games folder, may be trs2019\build....  or something similar reflecting a Trainz version and a randomly named folder of nine characters holding your user data.  Finding this latter folder is critical to restoring lost data (see below). Windows 10 provides a regular backup utility and there are a variety of other software backup utilities available online to ensure your files are protected. More information on the location of your local data folder is provided at [[Help:Moving_Content]].
 
+
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 an earlier version or you have lost your route due to a computer drive failure. The restoration process has changed for <b>TANE SP2</b>, <b>TRS2019</b> and <b>TrainzPlus</b> and the following guide will assist you in restoring a previous version of your route.
 
+
==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 readable only by Trainz (using "Rebuild Database")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==
+
==What and Where are the Backup Files?==
 +
From TANE SP2 on, your saved data are stored in backup archive files. These files have the suffix <b>.tzarc</b>. Trainz archive or .tzarc files are readable only by Trainz (using "Rebuild Database") and cannot be edited by an end user.
 
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 xxxxxx xxxxxx.tzarc_zzzzz where zzzzz is a random number (TANE SP 2; in TRS2019, the suffix "_zzzzz" is no longer used).
 
To find your most recent .tzarc file, sort the backups folder by date and then look for the KUID that matches 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.
  
==Restoring the Backup Files==
+
===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. The <b>backups folder</b> is much like your computer's "Recycle Bin" and contains copies of saved and deleted content. Here you will see folders named with a YY-MM-DD date format (i.e., 20-08-07 means 7th August 2020). Within each dated folder are numerous files and folders and the important files you will need for your restore process are the .tzarc files. Realize, that should you be needing to restore due to a hard drive failure, you must locate the .tzarc files in your backup storage system (cloud, alternate computer, cloud storage). 
 +
 
 +
==Restoring from 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.
 
Please note that these principles also apply to sessions and other assets.
 
Please note that these principles also apply to sessions and other assets.
 
+
<TABLE>
 +
<tr valign="top">
 +
<td>[[file:Steps.PNG|link=]]</td>
 +
<td><span style="font-size: 17px; font-weight: 700;">Steps:'''</span><br>
 +
</TD>
 +
<TD>
 
* 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 (e.g., C:\Users\<user name>\AppData\Local\N3V Games\trs19\build lowxu4v61\editing).
* Rename the file by removing the "_xxxxx" suffix (i.e. the file MUST be named in the format KUID xxx xxxx.tzarc)
+
* TANE SP2 only: rename the file by removing the "_zzzzz" suffix (i.e., the file MUST be named in the format KUID xxxxxx xxxxxx.tzarc)
* You may be prompted "If you change a file name extension, the file might become unusable. Are you sure you want it changed?". Answer Yes.
+
** You may be prompted "If you change a file name extension, the file might become unusable. Are you sure you want it changed?". Answer 'Yes'.
* 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 then 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
* The restored asset will now show as "Open for Edit"
+
* The restored asset will now show as "Open for Edit" (this may take up to 30 seconds)
 
* Select the asset in Content Manager and right-click > Submit Edits
 
* Select the asset in Content Manager and right-click > Submit Edits
 +
</TD>
 +
</TR>
 +
</TABLE>
 +
Your route has now been restored and is ready to be worked on again.
  
Your route has now been restored.
+
===Restoring (Copying) to a Different Hard Drive===
 +
 
 +
In the event that you are needing to restore from a backup location other than the one your route is (or was) located on, you will need to move the selected .tzarc file(s) into the /editor subfolder on the new drive/new local app data folder.  
  
 
==Deleting the Backup Folder==
 
==Deleting the Backup Folder==
Line 59: Line 65:
 
Of course, once deleted, the files are then permanently irrecoverable.
 
Of course, once deleted, the files are then permanently irrecoverable.
  
 +
----
 +
----
 +
 +
='''Trainz Wiki'''=
 +
<table cellpadding="4" bgcolor=#ffffff>
 +
<tr valign="top">
 +
<td>[[file:TrainzWiki.png|link=]]</td>
 +
<td>
 +
<span style="font-size: 17px;">'''Other Guides and Help Pages for Restoring Content'''</span><br>
 +
*'''[[How_to_Manage_Backups]]'''
 +
*'''[[How_to_Perform_Database_Repairs|Database Repairs]]'''
 +
*'''[[Help:Content_Manager|Content Manager]]'''
 +
*'''[[Help:TRS2019_Trainz_Content|Trainz Content]]'''
 +
*'''<span class="plainlinks">[http://online.ts2009.com/mediaWiki/index.php/Help:TRS19 TRS2019 Help Main Page]</span>'''
 +
*'''<span class="plainlinks">[http://online.ts2009.com/mediaWiki/index.php/HowTo How to Guides]</span>'''
 +
 +
</td>
 +
</tr>
 +
</table>
 +
[[Category:TRS19]]
 
[[Category:Help]]
 
[[Category:Help]]

Latest revision as of 09:35, 5 August 2021

The information in this Wiki Page applies to TANE, TRS19 and Trainz Plus. While this Help article is focused on backing up and restoring Routes, the principles apply to restoring Sessions or other assets. With the introduction of Trainz A New Era Service Pack 2 (SP2), a number of changes have been introduced regarding how data are backed up and, if needed, restored. Managing backups is discussed in much detail at How_to_Manage_Backups.

Contents

[edit] In-game backups

New in TANE SP2 and carried through subsequent versions, backups are made continuously while you are editing a route or a session. If you have a power loss or if the game crashes for some reason, it is possible to pick up pretty much where you left off by simply reloading the map you were working on and following the prompts. You will be presented with a choice to either "Use changes" or "Revert changes":

  • If you choose "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 be included.

Note that if you want to keep this reloaded version of the route, after loading and checking that everything is ok, you need to "Save" to permanently retain those most recent changes. In other words, if you choose "Use Changes" then exit the route without saving, those changes will be lost. Also, if disk activity was occurring at the time the fault occurred, relevant parts of the route have a small chance of being corrupted. After reloading the autosaved changes into Surveyor (i.e.. Use Changes), and before saving the route, you should check that no corruption has occurred. If you decide that the route is too corrupt to keep, close Surveyor without saving to permanently discard the autosaved changes (revert back to the last manually saved version).

[edit] Manual Backup Process (External Backup)

DotPoint.JPG Your Trainz data files are backed-up to a folder on your hard drive every time you press "Save".

Should your hard drive fail and you do not have your Trainz data saved elsewhere, then you will lose it all. It is highly recommended, therefore, that you back up your local data folder to an external hard drive or cloud server to ensure that your data are recoverable.

In Windows, your data folder is stored by default at the location: C:\Users\<user name>\AppData\Local\N3V Games\. These may be hidden folders on your system; and "<user name>" is your name on your computer device (seen at login) and not your Trainz user name. Within the \N3V Games folder, may be trs2019\build.... or something similar reflecting a Trainz version and a randomly named folder of nine characters holding your user data. Finding this latter folder is critical to restoring lost data (see below). Windows 10 provides a regular backup utility and there are a variety of other software backup utilities available online to ensure your files are protected. More information on the location of your local data folder is provided at Help:Moving_Content.

[edit] Restoring a Route

There may be a time where a route becomes corrupted and you need to restore an earlier version or you have lost your route due to a computer drive failure. The restoration process has changed for TANE SP2, TRS2019 and TrainzPlus and the following guide will assist you in restoring a previous version of your route.

[edit] What and Where are the Backup Files?

From TANE SP2 on, your saved data are stored in backup archive files. These files have the suffix .tzarc. Trainz archive or .tzarc files are readable only by Trainz (using "Rebuild Database") and cannot be edited by an end user. 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 xxxxxx xxxxxx.tzarc_zzzzz where zzzzz is a random number (TANE SP 2; in TRS2019, the suffix "_zzzzz" is no longer used). To find your most recent .tzarc file, sort the backups folder by date and then look for the KUID that matches your route.

[edit] 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. The backups folder is much like your computer's "Recycle Bin" and contains copies of saved and deleted content. Here you will see folders named with a YY-MM-DD date format (i.e., 20-08-07 means 7th August 2020). Within each dated folder are numerous files and folders and the important files you will need for your restore process are the .tzarc files. Realize, that should you be needing to restore due to a hard drive failure, you must locate the .tzarc files in your backup storage system (cloud, alternate computer, cloud storage).

[edit] Restoring from 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. Please note that these principles also apply to sessions and other assets.

Steps.PNG Steps:
  • Find the .tzarc file you wish to restore
  • Copy the file from \backups into \editing (e.g., C:\Users\<user name>\AppData\Local\N3V Games\trs19\build lowxu4v61\editing).
  • TANE SP2 only: rename the file by removing the "_zzzzz" suffix (i.e., the file MUST be named in the format KUID xxxxxx xxxxxx.tzarc)
    • You may be prompted "If you change a file name extension, the file might become unusable. Are you sure you want it changed?". Answer 'Yes'.
  • Open Content Manager then click Developer > Rebuild Database
  • This will result in your .tzarc file being read back into the database
  • The restored asset will now show as "Open for Edit" (this may take up to 30 seconds)
  • Select the asset in Content Manager and right-click > Submit Edits

Your route has now been restored and is ready to be worked on again.

[edit] Restoring (Copying) to a Different Hard Drive

In the event that you are needing to restore from a backup location other than the one your route is (or was) located on, you will need to move the selected .tzarc file(s) into the /editor subfolder on the new drive/new local app data folder.

[edit] 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.



[edit] Trainz Wiki

TrainzWiki.png

Other Guides and Help Pages for Restoring Content

Personal tools