How to Manage Backups: Difference between revisions

From TrainzOnline
Jump to navigationJump to search
Pware (talk | contribs)
Pware (talk | contribs)
mNo edit summary
Line 17: Line 17:
</tr>
</tr>
<tr valign="top">
<tr valign="top">
<td>[[image:DotPoint.JPG|link=]]</td>
<td>[[image:DotPoint.JPG|10px|link=]]</td>
<td>'''Trainz will automatically backup your current route and session in Surveyor while you work. You can set the number of backups created each day (including setting it to 0)'''</td>
<td>'''Trainz will automatically backup your current route and session in Surveyor while you work. You can set the number of backups created each day (including setting it to 0)'''</td>
</tr>
</tr>
<tr valign="top">
<tr valign="top">
<td>[[image:DotPoint.JPG|link=]]</td>
<td>[[image:DotPoint.JPG|10px|link=]]</td>
<td>'''You can use Content Manager to manually create backups of routes, sessions and assets as often as you need'''</td>
<td>'''You can use Content Manager to manually create backups of routes, sessions and assets as often as you need'''</td>
</tr>
</tr>
<tr valign="top">
<tr valign="top">
<td>[[image:DotPoint.JPG|link=]]</td>
<td>[[image:DotPoint.JPG|10px|link=]]</td>
<td>'''Both the manual and automatic backups can be restored to Trainz by Content Manager'''</td>
<td>'''Both the manual and automatic backups can be restored to Trainz by Content Manager'''</td>
</tr>
</tr>
<tr valign="top">
<tr valign="top">
<td>[[image:DotPoint.JPG|link=]]</td>
<td>[[image:DotPoint.JPG|10px|link=]]</td>
<td>'''You can backup all your user data (built-in assets, DLS downloads, DLC purchases, your own creations)'''</td>
<td>'''You can backup all your user data (built-in assets, DLS downloads, DLC purchases, your own creations)'''</td>
</tr>
</tr>
Line 102: Line 102:
</tr>
</tr>
<tr valign="top">
<tr valign="top">
<td>[[image:DotPoint.JPG|link=]]</td>
<td>[[image:DotPoint.JPG|10px|link=]]</td>
<td>'''Only a set number of backups are created each day'''</td>
<td>'''Only a set number of backups are created each day'''</td>
</tr>
</tr>
<tr valign="top">
<tr valign="top">
<td>[[image:DotPoint.JPG|link=]]</td>
<td>[[image:DotPoint.JPG|10px|link=]]</td>
<td>'''Only 7 days of backups are kept'''</td>
<td>'''Only 7 days of backups are kept'''</td>
</tr>
</tr>
Line 119: Line 119:
<tr valign="top">
<tr valign="top">
<td><span style="font-size: 17px; font-weight: 700;">Steps:'''</span><br>
<td><span style="font-size: 17px; font-weight: 700;">Steps:'''</span><br>
[[image:LauncherSettingsTabs.png|link=|alt=Launcher Settings Tabs]]<br>
<table>
<table>
<tr valign="top">
<tr valign="top">
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
<td>select '''Trainz Settings''' from the '''Launcher''' and then click the '''Dev''' tab.</td>
<td>select '''Trainz Settings''' from the '''Launcher''' and then click the '''Dev''' tab.<br>
[[image:LauncherSettingsTabs.png|link=|alt=Launcher Settings Tabs]]</td>
</tr>
</tr>
<tr valign="top">
<tr valign="top">
Line 133: Line 133:
<table>
<table>
<tr valign="middle">
<tr valign="middle">
<td>[[image:DotPoint.JPG|link=]]</td>
<td>[[image:DotPoint.JPG|10px|link=]]</td>
<td>[[image:LauncherSettingsDailyBackups7.png|link=|alt=Launcher Settings Tabs]]</td>
<td>[[image:LauncherSettingsDailyBackups7.png|link=|alt=Launcher Settings Tabs]]</td>
<td>If you are working on developing a new route or session then '''7''' daily backups could be a suitable number.</td>
<td>If you are working on developing a new route or session then '''7''' daily backups could be a suitable number.</td>
</tr>
</tr>
<tr valign="middle">
<tr valign="middle">
<td>[[image:DotPoint.JPG|link=]]</td>
<td>[[image:DotPoint.JPG|10px|link=]]</td>
<td>[[image:LauncherSettingsDailyBackups3.png|link=|alt=Launcher Settings Tabs]]</td>
<td>[[image:LauncherSettingsDailyBackups3.png|link=|alt=Launcher Settings Tabs]]</td>
<td>If you are making minor changes to existing routes or sessions then '''3''' or '''4''' daily backups could be a suitable number.</td>
<td>If you are making minor changes to existing routes or sessions then '''3''' or '''4''' daily backups could be a suitable number.</td>
</tr>
</tr>
<tr valign="middle">
<tr valign="middle">
<td>[[image:DotPoint.JPG|link=]]</td>
<td>[[image:DotPoint.JPG|10px|link=]]</td>
<td>[[image:LauncherSettingsDailyBackups0.png|link=|alt=Launcher Settings Tabs]]</td>
<td>[[image:LauncherSettingsDailyBackups0.png|link=|alt=Launcher Settings Tabs]]</td>
<td>If you are not working on any routes or sessions then '''0''' daily backups could be a suitable number - but '''remember to reset this when you do need the automatic backups again'''.</td>
<td>If you are not working on any routes or sessions then '''0''' daily backups could be a suitable number - but '''remember to reset this when you do need the automatic backups again'''.</td>
Line 271: Line 271:
<td>[[image:Stop.PNG|link=]]</td>
<td>[[image:Stop.PNG|link=]]</td>
<td><span style="font-size: 15px; font-weight: 700;">WARNING:</span><br>
<td><span style="font-size: 15px; font-weight: 700;">WARNING:</span><br>
The "usual" method of dragging and dropping the backup folder into '''Content Manager''' to restore it no longer works. Instead the following method is recommended.
The old method of dragging and dropping the backup folder into '''Content Manager''' to restore it does not work. Instead the following method is recommended.
</td>
</td>
</tr>
</tr>
Line 363: Line 363:
<table cellpadding=2 bgcolor=#c1e7e7>
<table cellpadding=2 bgcolor=#c1e7e7>
<tr valign="top">
<tr valign="top">
<td>[[image:DotPoint.JPG|link=]]</td>
<td>[[image:DotPoint.JPG|10px|link=]]</td>
<td>'''Manual backups are stored as .CDP files'''</td>
<td>'''Manual backups are stored as .CDP files'''</td>
</tr>
</tr>
<tr valign="top">
<tr valign="top">
<td>[[image:DotPoint.JPG|link=]]</td>
<td>[[image:DotPoint.JPG|10px|link=]]</td>
<td>'''Many assets can be stored in a single .CDP file'''</td>
<td>'''Many assets can be stored in a single .CDP file'''</td>
</tr>
</tr>
Line 424: Line 424:
<table cellpadding=2 bgcolor=#c1e7e7>
<table cellpadding=2 bgcolor=#c1e7e7>
<tr valign="top">
<tr valign="top">
<td>[[image:DotPoint.JPG|link=]]</td>
<td>[[image:DotPoint.JPG|10px|link=]]</td>
<td>'''Simply drag and drop the backup CDP file or files into Content Manager'''</td>
<td>'''Simply drag and drop the backup CDP file or files into Content Manager'''</td>
</tr>
</tr>
Line 468: Line 468:
<table cellpadding=2 bgcolor=#c1e7e7>
<table cellpadding=2 bgcolor=#c1e7e7>
<tr valign="top">
<tr valign="top">
<td>[[image:DotPoint.JPG|link=]]</td>
<td>[[image:DotPoint.JPG|10px|link=]]</td>
<td>'''If you are using a manual backup method then devise a simple backup plan and stick to it'''</td>
<td>'''If you are using a manual backup method then devise a simple backup plan and stick to it'''</td>
</tr>
</tr>
Line 586: Line 586:
<table cellpadding=2 bgcolor=#c1e7e7>
<table cellpadding=2 bgcolor=#c1e7e7>
<tr valign="top">
<tr valign="top">
<td>[[image:DotPoint.JPG|link=]]</td>
<td>[[image:DotPoint.JPG|10px|link=]]</td>
<td>'''Picklists have to be exported and imported as text files'''</td>
<td>'''Picklists have to be exported and imported as text files'''</td>
</tr>
</tr>
Line 606: Line 606:
<table cellpadding=2 bgcolor=#c1e7e7>
<table cellpadding=2 bgcolor=#c1e7e7>
<tr valign="top">
<tr valign="top">
<td>[[image:DotPoint.JPG|link=]]</td>
<td>[[image:DotPoint.JPG|10px|link=]]</td>
<td>'''You can backup ALL your installed content including built-ins and DLC'''</td>
<td>'''You can backup ALL your installed content including built-ins and DLC'''</td>
</tr>
</tr>
Line 650: Line 650:
<table cellpadding=2 bgcolor=#c1e7e7>
<table cellpadding=2 bgcolor=#c1e7e7>
<tr valign="top">
<tr valign="top">
<td>[[image:DotPoint.JPG|link=]]</td>
<td>[[image:DotPoint.JPG|10px|link=]]</td>
<td><span style="font-size: 17px; font-weight: 700;">You will need to find a storage device or location, such as an external drive, that has <span style="text-decoration: underline;">more</span> available free space than the folder is using</span></td>
<td><span style="font-size: 17px; font-weight: 700;">You will need to find a storage device or location, such as an external drive, that has <span style="text-decoration: underline;">more</span> available free space than the folder is using</span></td>
</tr>
</tr>

Revision as of 22:42, 6 July 2026

Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 The information in this Wiki Page explains automatic and manual backups in T:ANE, TRS19, TRS22 and Trainz Plus.


Main Points:
Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 Trainz will automatically backup your current route and session in Surveyor while you work. You can set the number of backups created each day (including setting it to 0)
Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 You can use Content Manager to manually create backups of routes, sessions and assets as often as you need
Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 Both the manual and automatic backups can be restored to Trainz by Content Manager
Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 You can backup all your user data (built-in assets, DLS downloads, DLC purchases, your own creations)


  Top   Next Down Bottom

Automatic Backups vs Manual Backups

  Automatic Backups Manual Backups
Pros
Tick
  • set and forget - no need to remember to perform the backups
  • backups are stored in a set location
  • automatic restore after a crash
  • you control where the backups are stored and for how long
  • you control the backup file names
  • any assets can be backed up, not just routes and sessions
Cons
Cross
  • identifying the exact backup file to restore may not be easy
  • only routes and sessions can be backed up
  • last 7 days of backups only are kept
  • you have to remember to perform the backup
  • you have to remember where you stored the backups
  • manual restore after a crash


  Top Next Up Next Down Bottom

Automatic Backups

Creating Automatic Backups

In Summary:
Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 Only a set number of backups are created each day
Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 Only 7 days of backups are kept

This is a Set and Forget operation. You simply tell Trainz how many backups you want created each day and the program takes care of the rest.


Steps:
select Trainz Settings from the Launcher and then click the Dev tab.
Launcher Settings Tabs
One data entry box in this tab will be named Daily backups to keep and it will have a default value of 7. Set it to the number of backups you want each day.
Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 Launcher Settings Tabs If you are working on developing a new route or session then 7 daily backups could be a suitable number.
Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 Launcher Settings Tabs If you are making minor changes to existing routes or sessions then 3 or 4 daily backups could be a suitable number.
Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 Launcher Settings Tabs If you are not working on any routes or sessions then 0 daily backups could be a suitable number - but remember to reset this when you do need the automatic backups again.
Warning:
If you set 0 daily backups then there will be no option to restore your route/session to the latest automatic backup after a crash

Large Number of Daily Backups Small Number of Daily Backups

Tick more backup storage space is needed
Tick shorter time between backups so less work could be lost

Tick less backup storage space is needed
Tick longer time between backups so more work could be lost

Only the last 7 days of backups are kept and this number cannot be changed.

Restoring Automatic Backups

The automatic backups are stored in a backup folder in your Trainz local data folder. The location of this folder is held in your Launcher - Trainz Settings - Install tab.

Steps:
Highlight the Local Data Folder address and copy to your OS clipboard - press  Ctrl   C 
Open Windows Explorer and paste ( Ctrl   V ) the address into the Address Bar


This folder can also found using Windows Explorer by following a similar folder path as shown below.


Where  idname  is the first 5 characters of your Windows logon name and  random  will be a random sequence of letters and numbers identifying the Trainz Build Number.

Notes:

Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 The drive letter (C:) and the path will be different if you have previously moved your User Data Folder to a different drive and/or location. If this is the case then use the folder address from the Launcher Install TAB
Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 If you are using TANE or TRS19 then that will be shown instead of TRS22
Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 If you are using Trainz Plus then its folder will be shown as TRS22
The TANE/TRS19/TRS22 folder may have several different build folders. If so then select the one that has a Date Modified entry that matches the date/time of your last route modification.


WARNING:

The old method of dragging and dropping the backup folder into Content Manager to restore it does not work. Instead the following method is recommended.


Steps:
 Open The Backups Folder:
Using Windows File Explorer, open your local data folder and then open the backups folder.
Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 the backups that have been created will be listed by their dates using the YY-MM-DD date format
Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 only daily backups from the last 7 days will be kept
 Identify the Backup to Restore:
Open the backup folder for the date that you want. A list of backup files and folders created that day will be shown.


Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 if you know the time of the backup then sort the entries by date and time
Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 if you know the kuid of the backup (it will be the same as used by the route/session) then sort the entries by name (but there may be several files with the same kuid)
 Restore the Backup To Trainz:
  1. select the .tzarc file that contains your backup (e.g. the last created version by date and time)
  2. copy it into the Editing folder - this folder will be directly under the same build <number> folder that contains your backups
  3. if the .tzarc filename is followed by a number sequence (e.g. kuid 45176 100893.tzarc_323888034) then rename the file to remove all the characters AFTER the .tzarc so kuid 45176 100893.tzarc_323888034 becomes kuid 45176 100893.tzarc
  4. open Content Manager
  5. run a database repair
  6. IF Content Manager shows your restored asset as Open for Edit then submit it


More details, including tips on troubleshooting, can be found in the Trainz Knowledge Base at Restoring Backups

  Top Next Up Next Down Bottom


Creating Manual Backups

Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 Manual backups are stored as .CDP files
Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 Many assets can be stored in a single .CDP file

Steps:
open Content Manager and use a search filter to identify the assets to be backed up. Some examples:-

Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 Today Filter to show all assets that have been altered today
Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 Launcher Settings Tabs to show all installed routes that are yours
highlight the asset or assets (more than one asset can be included in each backup file)
right mouse click on one of the highlighted assets and select Export to CDP
Export to CDP
select a drive, folder and enter a backup filename


Restoring Manual Backups

Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 Simply drag and drop the backup CDP file or files into Content Manager

Steps:
open Content Manager
open Windows File Explorer and locate the backup folder
highlight the .CDP file or files to be restored
drag and drop the file or files from Windows File Explorer into Content Manager
if the assets being restored are already installed in Content Manager then their status will be shown as Open for Edit. Select and submit those assets.

Restore from backup


Backup Plan Basics

Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 If you are using a manual backup method then devise a simple backup plan and stick to it

The most important parts of any backup plan are:-

Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 make regular backups - how often will depend on the complexity of the project
Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 keep duplicate sets of backups including on offline storage
Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 keep previous backup sets, not just the latest ones - how many past sets you will want to keep will depend on factors such as available storage
Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 have a simple but consistent file naming system to be able to quickly identify the backup you need to restore lost work


Sample Backup Plan:
on a drive that is always attached to your system create a Project Backups folder
in this folder create another folder named Today
Online Project Backups folder
use this folder to store your regular backups for today. For example, when you take a break and exit from Surveyor, start Content Manager and backup the current project (e.g. a route, a session or both) to the Today folder
Todays Backups folder
name each backup using the name of the project and the time as shown in the example above
Why Keep Separate Time Backups For The Same Day?

Suppose that after your first backup of the day, at say 07:52, you decided to make some significant changes to your route. The later backups made at 12:30 and 14:10 included this change. By 17:00 you decide that this major change is not working and you need to return the route to its starting state. If your only backup was the last one you had made at 14:10 then you could not restore the route to its starting state.

at the end of each day copy the Today folder to another drive (external or internal) into a folder also called Project Backups
rename the Today folder on the 2nd drive to a format that identifies the date of the backups it contains (using the yyyy-mm-dd format) as shown below
Offline Project Backups folder
copy this renamed folder to an external detachable drive into its Project Backups folder - this will give you a second backup copy
when starting work the next day, delete the contents of the Today folder on your main drive and make the first backup of the day using the project assets in their initial state for the day
How Long Should You Keep The Daily Backups?

The ideal answer is until after the project has been finished but in reality it will depend on your available storage space.

Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 Once the project has been completed then the backup folders and files can be deleted
Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 If there is insufficient space to keep a large number of backups, then delete the oldest backup folders first
If a decision is later made to restart work on the route (e.g. to update it after a new version of Trainz has been released) then it would be considered to be a brand new project and the backup procedure can be restarted from that point.


  Top Next Up   Bottom


Backing Up and Restoring Picklists

Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 Picklists have to be exported and imported as text files

Picklists cannot be backed up manually using .CDP files. They must be exported as text files.

Detailed instructions on backing up and restoring Picklists as text files can be found on the Trainz Wiki Page at:-


Backing Up All Your User Content

Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 You can backup ALL your installed content including built-ins and DLC
You can make a backup copy of all your installed content (buildings, tracks, rolling stock, trees, routes, sessions, etc, etc). Everything you have downloaded and installed from the DLS and other web sites, all the built-in content and all your DLC packages. Also included will be all the screenshots you have captured and your automatic backups. In short, everything but the program "executables" and utilities that form the Trainz program itself.

All of this data is stored in your Local Data Folder.


Warning:
Be aware that this could be a very large quantity of data that could take a lot of time and space to backup

Steps:

 Locate Your Local Data Folder:

The name and location of this folder is held in your Launcher - Trainz Settings - Install tab. The name and location can vary between installations as in the example shown below

Data Folder location

 Determine the Size of the Folder:
  1. Use Windows File Explorer to locate this folder in its drive as shown in the Local Data Folder information above
  2. Right Mouse Click on the folder name and select the Properties menu option
This will display the folder statistics - there may be a delay while the data is collected and displayed. In the example shown below, the Local Data Folder is just over 69 GB in size

Data Folder propertiesData Folder size

Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127 You will need to find a storage device or location, such as an external drive, that has more available free space than the folder is using
 Copy the Folder:
  1. Close the Properties Window
  2. Right Mouse Click on the folder name and select the Copy menu option
  3. Open the Destination Drive and select (or create) a suitable backup folder
  4. Right Mouse Click on the backup folder and select the Paste menu option - this could easily take a long time (even hours) depending on the size of the data


For very large Local Data Folders the backup process can take hours to complete. Windows File Explorer is not the fastest nor the most efficient method of copying large sets of data files. It may be worth your while to use a specialised file copying utility that can perform the task faster while still providing intelligent copying and data checking


  Top Next Up    

Trainz Wiki

More Tutorials and Guides to Using Trainz

Related Links


This page was created by Trainz user pware in January 2020 and was last updated as shown below.