How to Perform Database Repairs

From TrainzOnline
(Difference between revisions)
Jump to: navigation, search
m (→‎How to Create a "Clean Database")
m
Line 1: Line 1:
 
<table width=1000>
 
<table width=1000>
 
<tr valign="top">
 
<tr valign="top">
−
<td>The information in this Wiki Page applies to '''TANE''', '''TRS19''', '''Trainz Plus''' and '''TRS22'''.<br>
+
<td colspan=2>The information in this Wiki Page applies to '''TANE''', '''TRS19''', '''Trainz Plus''' and '''TRS22'''. This guide will take you through the process of performing manual asset updates using '''Content Manager'''. Updates occur whenever new versions of assets installed on your system are uploaded to the '''DLS'''.</td>
−
 
+
−
This guide will take you through the process of performing manual database repairs and clean database installs. '''Trainz''' will automatically perform database repairs when it detects corruption in the Trainz database but sometimes a manual repair or even a manual clean install of the database is required.</td>
+
 
</tr>
 
</tr>
−
</table>
+
<tr valign="top">
−
 
+
<td width=375>
 
__TOC__
 
__TOC__
−
<table width=1000> <!-- BEGIN Nav Buttons Table -->
+
</td>
 +
<td>
 +
<table bgcolor=#000000 cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
−
<td width=729><span id="stepWhat"></span>&nbsp;</td>
+
<td>
−
<td width=46>[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
+
<table bgcolor=#ffffb0 cellpadding=2>
−
<td width=75>&nbsp;</td>
+
<tr valign="top">
−
<td width=75>[[file:NextDown.png|link=#stepWhy|alt=Next Down|Next Down]]</td>
+
<td width=25>[[image:NotePad.PNG|link=]]</td>
−
<td width=75>[[file:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
+
<td><span style="font-size: 17px; font-weight: 700;">Notes:'''</span><br>
 +
----
 +
The section describing how to create a '''Clean Install''' (i.e. containing only '''Base''' and '''Built-in''' assets) has been removed because the technique described no longer works in the latest versions of '''Trainz'''.
 +
</td>
 
</tr>
 
</tr>
−
</table> <!-- END Nav Buttons Table -->
+
</table>
−
 
+
</td>
−
='''What is the "Trainz Database"?'''=
+
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
  
 
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
 
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
−
<td>The '''Trainz Database''' contains all the installed assets</td>
+
<td>'''Trainz''' will perform automatic updates when in '''Driver''' and '''Surveyor''' modes but you have little control over when and how this occurs</td>
−
</tr>
+
−
</table>
+
−
 
+
−
<table width=1000>
+
−
<tr valign="top">
+
−
<td>In the earliest Trainz versions all the assets that came installed with Trainz, or that you installed from the DLS or downloaded as .cdp files, were stored as separate folders on your designated data drive. This made it easy to access the assets for editing and other operations. However the penalty was that each time you started Trainz it had to scan the assets to check their integrity and the more assets you had the longer the startup took. This led to a great many complaints from users.
+
−
 
+
−
Today, all installed Trainz assets are added as records in an asset database which has significantly sped up the startup process and has reduced the possibility of accidental data corruption by users. The penalty is that users can no longer access the installed assets by using Windows Explorer. Access to the assets in the database for editing and examination is through the '''Content Manager''' program.
+
−
 
+
−
Because it is a database manager, '''Content Manager''' also provides users with many more search, display and management options than were ever previously possible. Each entry in the display shown below is a single record in the Trainz database. Each entry can be easily opened for editing, it can be deleted, copied (cloned) and updated. New assets can be manually created or installed from other sources.</td>
+
−
</tr>
+
−
</table>
+
−
<br>
+
−
<table width=1000>
+
−
<tr>
+
−
<td>[[file:DBR_EDBR20.png|link=]]</td>
+
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 45: Line 36:
 
<table width=1000> <!-- BEGIN Nav Buttons Table -->
 
<table width=1000> <!-- BEGIN Nav Buttons Table -->
 
<tr valign="top">
 
<tr valign="top">
−
<td width=729><span id="stepWhy"></span>&nbsp;</td>
+
<td width=729><span id="stepFilter"></span>&#160;</td>
−
<td width=46>[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
+
<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
−
<td width=75>[[file:NextUp.png|link=#stepWhat|alt=Next Up|Next Up]]</td>
+
<td width=75>&#160;</td>
−
<td width=75>[[file:NextDown.png|link=#stepHow|alt=Next Down|Next Down]]</td>
+
<td width=75>[[image:NextDown.png|link=#stepDLS|alt=Next Down|Next Down]]</td>
−
<td width=75>[[file:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
+
<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
 
</tr>
 
</tr>
 
</table> <!-- END Nav Buttons Table -->
 
</table> <!-- END Nav Buttons Table -->
−
='''Why Would a Database Repair (DBR) Be Needed?'''=
+
='''Set Up An Update Filter'''=
  
−
<span style="font-weight: 700; font-size: 15px;">A Quote from N3V</span>
+
<table width=1000 bgcolor=#000000 cellpadding=2>
−
 
+
−
<table width=1000>
+
 
<tr valign="top">
 
<tr valign="top">
−
<td>&nbsp;&nbsp;&nbsp;&nbsp;</td>
+
<td>
−
<td>"In terms of DB repairs, it should only be necessary if the program is updated or crashes. My understanding of the additional repairs are for things that are done outside the program function [i.e. outside of '''Content Manager''' and '''Surveyor'''] (like manually adding content into the local data folder) so in that case the db repair 'discovers' the new content".</td>
+
<table width=996 bgcolor=#ffffe0 cellpadding=2>
 +
<tr valign="top">
 +
<td>[[image:PencilTips.PNG|link=]]</td>
 +
<td>
 +
<table>
 +
<tr valign="top">
 +
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>a '''Update Filter''' allows you to easily perform this operation at any time</td>
 
</tr>
 
</tr>
−
</table>
 
−
 
−
<table width=1000>
 
 
<tr valign="top">
 
<tr valign="top">
−
<td>When '''Trainz''' is operating there is a great deal of database activity going on with records being opened and closed, and data being read and written. Corruption of the data is always possible, particularly if the power supply is interrupted or the program is suddenly terminated (a "crash") while records are open or being written. For this reason, '''Content Manager''' comes equipped with automatic and manual database repair tools.</td>
+
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>because this is something that you will probably be doing on a regular basis, it would be a good idea to save the filter to perform the task of searching for asset updates.</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
−
<br>
 
−
<table width=1000 bgcolor=#000000>
 
−
<tr valign="top">
 
−
<td>
 
−
<table bgcolor=#ffffe0>
 
−
<tr valign="top">
 
−
<td>[[file:PencilTips.PNG|link=]]</td>
 
−
<td>A common, but not exclusive, cause of database problems and even '''CTD'''s (crashes to desktop) may be your antivirus program. Everytime '''Trainz''' accesses the database your AV program may perform a scan of the database.<br><br>
 
−
Adding '''TANE.exe''', '''TRS19.exe''' and '''TRS22.exe''' to your AV programs '''real time scan''' exclusion list can potentially resolve many of these issues by preventing the AV from accessing the database.
 
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 84: Line 69:
 
</table>
 
</table>
 
<br>
 
<br>
−
<table width=1000> <!-- BEGIN Nav Buttons Table -->
+
<table cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
−
<td width=729><span id="stepHow"></span>&nbsp;</td>
+
<td colspan=2><span style="font-weight: 700; font-size: 17px;">Steps:</span></td>
−
<td width=46>[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
+
−
<td width=75>[[file:NextUp.png|link=#stepWhy|alt=Next Up|Next Up]]</td>
+
−
<td width=75>[[file:NextDown.png|link=#stepEDBR|alt=Next Down|Next Down]]</td>
+
−
<td width=75>[[file:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
+
 
</tr>
 
</tr>
−
</table> <!-- END Nav Buttons Table -->
 
−
='''How to Perform a Database Repair (a DBR)'''=
 
−
 
−
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 
 
<tr valign="top">
 
<tr valign="top">
−
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
+
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
−
<td>A '''DBR''' performs a "surface scan" of the database detecting missing content and content errors. It will update your database and can clean up some corrupted data.</td>
+
<td><span style="font-size: 17px; font-weight: 700;">Open a Content Manager Filter:</span>
−
</tr>
+
<table> <!-- BEGIN Step 1 table -->
−
</table>
+
−
<br>
+
−
This is the simplest and (usually) the fastest option.<br>
+
−
 
+
−
<table bgcolor=#000000>
+
 
<tr valign="top">
 
<tr valign="top">
 +
<td>[[image:Update_Filter01.png|link=]]</td>
 
<td>
 
<td>
−
<table bgcolor=#ffffb0>
 
−
<tr valign="top">
 
−
<td>[[file:NotePad.PNG|link=]]</td>
 
−
<td><span style="font-size: 17px;">'''Notes:'''</span><br>
 
−
----
 
−
Perform a '''DBR''' if you have:-
 
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
−
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
+
<td width=25>[[image:DotPoint1Blue.png|link=]]</td>
−
<td>'''unexpected problems''' with missing content</td>
+
<td>from the '''Trainz''' Launcher, select <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&#160;Manage Content&#160;</span></td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[image:DotPoint.JPG|10px|link=]]</td>
+
<td>[[image:DotPoint2Blue.png|link=]]</td>
−
<td>content '''errors with installed assets''' (particularly if those assets did not previously show any problems)</td>
+
<td>in the '''Filter''' drop down box, select '''Custom...'''
 +
</td>
 
</tr>
 
</tr>
−
<tr valign="top">
+
<tr>
−
<td colspan=2>A '''DBR''' updates your database, revalidates the content and can often clear up any corruption that has occurred.</td>
+
<td colspan=2>
 +
<br>This will produce the following filter options...<br>
 +
[[image:Update_Filter02a.png|link=]]
 +
</td>
 +
</tr>
 +
</table> <!-- END Step 1 table -->
 +
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 129: Line 103:
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
−
<td colspan=2>
+
<td>[[image:DotPoint2.JPG|link=]]</td>
−
<table bgcolor=#ffffe0>
+
<td><span style="font-size: 17px; font-weight: 700;">Configure:</span>
 +
<table> <!-- BEGIN Step 2 table -->
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[file:PencilTips.PNG|link=]]</td>
+
<td>[[image:Update_Filter03.png|link=]]</td>
−
<td>If you have installed a new asset that '''Content Manager''' reports has having '''missing''' or '''unknown''' assets then a '''DBR''' is '''very unlikely''' to find those missing assets.
+
<td>
 +
<table>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1Blue.png|link=]]</td>
 +
<td>open the '''Asset KUID''' drop down box and select '''Out of date'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint2Blue.png|link=]]</td>
 +
<td>leave the '''Out of date''' setting at '''True'''</td>
 +
</tr>
 +
<tr>
 +
<td colspan=2>
 +
<br>This will produce the following filter options...<br>
 +
[[image:Update_Filter04a.png|link=]]
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 142: Line 130:
 
</td>
 
</td>
 
</tr>
 
</tr>
−
</table>
 
−
<br>
 
−
<table width=1000>
 
 
<tr valign="top">
 
<tr valign="top">
−
<td colspan=2><span style="font-weight: 700; font-size: 17px;">Steps:</span></td>
+
<td>[[image:DotPoint3.JPG|link=]]</td>
−
</tr>
+
<td><span style="font-size: 17px; font-weight: 700;">... and Configure:</span><br>
 +
<table> <!-- BEGIN Step 3 table -->
 
<tr valign="top">
 
<tr valign="top">
−
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
+
<td>[[image:Update_Filter04.png|link=]]
−
<td><span style="font-size: 17px; font-weight: 700;">Open the Developer Menu</span>
+
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
−
<td colspan=2>From either the '''Launcher''' (below left) or '''Content Manager''' (below right) open the '''Developer''' menu and select the '''Rebuild Database''' option</td>
+
<td width=25>[[image:DotPoint1Blue.png|link=]]</td>
−
</tr>
+
<td>delete the '''Name''' filter by a <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">&#160;Left Click&#160;</span> on its [[image:CMFilterDeleteBtn.png|link=]] button on its extreme right</td>
−
<tr valign="top">
+
−
<td>[[file:DBR_EDBR01.png|link=]]</td>
+
−
<td>[[file:DBR_EDBR02.png|link=]]</td>
+
 
</tr>
 
</tr>
 
</table>
 
</table>
 +
<br>
 +
The final filter selection will look like ...<br>
 +
[[image:Update_Filter05.png|link=]]
 
</td>
 
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
−
 
+
</td>
−
<table width=1000>
+
</tr>
 
<tr valign="top">
 
<tr valign="top">
−
<td>The process will proceed automatically and unaided through a number of steps, '''only some of which are shown below'''. The time required for each step will vary enormously (some will take much longer than others) and the total time involved will depend on the number of assets installed, the speed of your system and other factors.
+
<td>[[image:DotPoint4.JPG|link=]]</td>
 +
<td><span style="font-size: 17px; font-weight: 700;">Save:</span><br>
 +
<table> <!-- BEGIN Step 4 table -->
 +
<tr valign="top">
 +
<td colspan=2>
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
 
<td width=25>[[image:DotPoint1Blue.png|link=]]</td>
 
<td width=25>[[image:DotPoint1Blue.png|link=]]</td>
−
<td>'''Scanning for deleted asset files'''<br>
+
<td>click the <span style="font-weight: 700; font-size: 15px;">Save</span> button</td>
−
[[file:DBR_EDBR03.png|link=]]</td>
+
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:DotPoint2Blue.png|link=]]</td>
 
<td>[[image:DotPoint2Blue.png|link=]]</td>
−
<td>'''Scanning for added asset files'''<br>
+
<td>enter a meaningful name for your filter and click <span style="font-weight: 700; font-size: 15px;">Ok</span></td>
−
[[file:DBR_EDBR04.png|link=]]</td>
+
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[image:DotPoint3Blue.png|link=]]</td>
+
<td colspan=2>[[image:Update_Filter06.png|link=]]</td>
−
<td>'''Importing built in assets'''<br>
+
−
[[file:DBR_EDBR06.png|link=]]</td>
+
−
</tr>
+
−
<tr valign="top">
+
−
<td>[[image:DotPoint4Blue.png|link=]]</td>
+
−
<td>'''Rebuilding cached asset data'''<br>
+
−
[[file:DBR_EDBR07.png|link=]]</td>
+
 
</tr>
 
</tr>
 
</table>
 
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>
−
<tr valign="top">
+
</table>
−
<td>The '''Rebuilding Trainz Asset Database''' window will disappear if the '''DBR''' process has been successfully completed without finding any errors. If errors have been found then the window will remain on the screen to report on the number of errors and warnings.</td>
+
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
 +
You can now select and run this filter whenever you want to check for and install any asset updates.<br>
 
<table width=1000> <!-- BEGIN Nav Buttons Table -->
 
<table width=1000> <!-- BEGIN Nav Buttons Table -->
 
<tr valign="top">
 
<tr valign="top">
−
<td width=729><span id="stepEDBR"></span>&nbsp;</td>
+
<td width=729><span id="stepDLS"></span>&#160;</td>
−
<td width=46>[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
+
<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
−
<td width=75>[[file:NextUp.png|link=#stepHow|alt=Next Up|Next Up]]</td>
+
<td width=75>[[image:NextUp.png|link=#stepFilter|alt=Next Up|Next Up]]</td>
−
<td width=75>[[file:NextDown.png|link=#stepClean|alt=Next Down|Next Down]]</td>
+
<td width=75>[[image:NextDown.png|link=#stepBuiltin|alt=Next Down|Next Down]]</td>
−
<td width=75>[[file:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
+
<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
 
</tr>
 
</tr>
 
</table> <!-- END Nav Buttons Table -->
 
</table> <!-- END Nav Buttons Table -->
  
−
='''How to Perform an Extended Database Repair (an EDBR)'''=
+
='''Updating Assets "Installed From DLS"'''=
  
−
<table width=1000 bgcolor="lightcyan" cellpadding=2>
+
<table width=1000>
 
<tr valign="top">
 
<tr valign="top">
−
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
+
<td>If you run your new filter and see one or more updated assets available for download that were "Installed from DLS", then the process is very simple.</td>
−
<td>An '''EDBR''' performs a "deep scan" of the database and checks that the data in every asset conforms to the rules for that type of asset</td>
+
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
−
<table width=XXX bgcolor=#000000 cellpadding=2>
+
<table width=1000>
 
<tr valign="top">
 
<tr valign="top">
 +
<td>[[image:Update_DLS01.png|link=]]</td>
 
<td>
 
<td>
−
<table width=XXX-4 bgcolor=#ffffb0 cellpadding=2>
+
<table bgcolor=#000000 width=250>
 
<tr valign="top">
 
<tr valign="top">
−
<td width=25>[[image:NotePad.PNG|link=]]</td>
+
<td>
−
<td><span style="font-size: 17px;">'''Notes:'''</span><br>
+
<table bgcolor=#ffffe0 width=246>
−
----
+
<tr valign="top">
 +
<td>[[image:PencilTips.PNG|link=]]</td>
 +
<td>Clicking the '''Status''' column heading will sort the order of the rows into order so that all the "Available for download" updates will be grouped together. A second click may be needed to bring them to the top of the list or closer to the top.</td>
 +
</tr>
 +
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000 bgcolor=#000000 cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[image:DotPoint.JPG|10px|link=]]</td>
+
<td>
−
<td>An '''EDBR''' is a more complex, slower and potentially more troublesome repair process</td>
+
<table width=996 bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 17px;">Steps:</span> To download and install all the updated assets:-  </td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[image:DotPoint.JPG|10px|link=]]</td>
+
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
−
<td>An '''EDBR''' puts every single asset in the database through the same error and compliance checks that are run when a new asset is installed</td>
+
<td>highlight all the items in the list shown as '''Installed from DLS''' in the '''Status''' column</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[image:DotPoint.JPG|10px|link=]]</td>
+
<td>[[image:DotPoint2.JPG|link=]]</td>
−
<td>Perform an '''EDBR''' if you have '''serious problems''' with your database that a DBR does not fix</td>
+
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">&#160;Right Click&#160;</span> on any one of the items and select '''Download''' from the popup menu</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan=2>[[image:Update_DLS02.png|link=]]<br><br>
 +
If the selected items have any new or updated dependencies that are also on the DLS then '''Content Manager''' will automatically find and download them as well</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 242: Line 239:
 
</table>
 
</table>
 
<br>
 
<br>
−
<table bgcolor=#ff0000>
+
<table bgcolor="Aquamarine">
 
<tr valign="top">
 
<tr valign="top">
 +
<td>[[image:LinkWiki.PNG|link=]]</td>
 
<td>
 
<td>
−
<table bgcolor=#fcbcbc>
+
More information on the '''Status''' labels used in '''Content Manager''' can be found on the '''Trainz Wiki Page''' at:-<br>
−
<tr valign="top">
+
'''[[Understand_Content_Manager_Status_Labels|How To Understand the Content Manager Status Labels]]'''<br>
−
<td>[[file:Stop.PNG|link=]]</td>
+
−
<td><span style="font-size: 15px; font-weight: 700;">CAUTION:</span><br>
+
−
It is not unusual for '''Content Manager''' to display a list of faulty assets '''after an EDBR''' that were not shown as faulty before the '''EDBR''' was run
+
 
</td>
 
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
−
</td>
+
<br>
 +
<table width=1000> <!-- BEGIN Nav Buttons Table -->
 +
<tr valign="top">
 +
<td width=729><span id="stepBuiltin"></span>&#160;</td>
 +
<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
 +
<td width=75>[[image:NextUp.png|link=#stepDLS|alt=Next Up|Next Up]]</td>
 +
<td width=75>[[image:NextDown.png|link=#stepMixture|alt=Next Down|Next Down]]</td>
 +
<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
 +
 
 +
='''Updating Built in, Base and Payware Assets'''=
 +
 
 +
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 +
<tr valign="top">
 +
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>Assets that are '''Built-in''', '''Base''' or '''Installed, Payware''' will require a few extra steps to be updated</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
−
<br>
+
 
 
<table width=1000>
 
<table width=1000>
 +
<tr valign="top">
 +
<td>The method shown above for updating '''DLS''' assets '''will not work''' for assets that are '''Built-in''', '''Base''' or '''Installed, Payware'''. If '''Content Manager''' lists updates for these types of assets as available for download then the process involves a few extra steps.</td>
 +
</tr>
 +
</table>
 +
 +
[[image:Update_Builtin01.png|link=]]
 +
 +
<table width=1000 cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
 
<td colspan=2><span style="font-weight: 700; font-size: 17px;">Steps:</span></td>
 
<td colspan=2><span style="font-weight: 700; font-size: 17px;">Steps:</span></td>
Line 263: Line 282:
 
<tr valign="top">
 
<tr valign="top">
 
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
 
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
−
<td><span style="font-size: 17px; font-weight: 700;">Open the Developer Menu</span></td>
+
<td><span style="font-size: 17px; font-weight: 700;">Select Built-in, Base and Payware Assets to Update:</span>
 +
<table> <!-- BEGIN Step 1 table -->
 +
<tr valign="top">
 +
<td>[[image:Update_Builtin02.png|link=]]</td>
 +
<td>
 +
<table>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1Blue.png|link=]]</td>
 +
<td>select all the '''Built-in''', '''Base''' or '''Installed, Payware''' items shown in your '''Updates Available''' list</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
−
<td colspan=2>
+
<td>[[image:DotPoint2Blue.png|link=]]</td>
−
<table> <!-- BEGIN Step 1 table -->
+
<td>'''Right''' click on any one of the items in the list. Note that the option '''Download''' is not available in the popup menu</td>
 +
</tr>
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[file:DBR_EDBR01.png|link=]]</td>
+
<td>[[image:DotPoint3Blue.png|link=]]</td>
−
<td>[[file:DBR_EDBR02.png|link=]]</td>
+
<td>select the option '''List Asset Versions'''</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 +
</td>
 +
</tr>
 +
<tr>
 +
<td colspan=2>
 +
<br>
 +
This will display all the available versions of the selected assets that are:-
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
−
<td colspan=2>From either the '''Launcher''' (left) or '''Content Manager''' (right):-</td>
+
<td width=10>[[image:RedDot10x10.png|link=]]</td>
 +
<td>on your system, and</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
−
<td width=25>[[image:DotPoint1Blue.png|link=]]</td>
+
<td>[[image:RedDot10x10.png|link=]]</td>
−
<td>open the '''Developer''' menu</td>
+
<td>on the DLS, and</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[image:DotPoint2Blue.png|link=]]</td>
+
<td>[[image:RedDot10x10.png|link=]]</td>
−
<td>hold down the <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;Ctrl&#160;</span> key</td>
+
<td>obsolete</td>
 +
</tr>
 +
</table>
 +
<br>
 +
[[image:Update_Builtin03.png|link=]]
 +
<br>
 +
You may need to click the '''Status''' column heading once or twice to sort them into order and group all the '''Available for download''' assets together.
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[image:DotPoint3Blue.png|link=]]</td>
+
<td>[[image:DotPoint2.JPG|link=]]</td>
−
<td>select the '''Rebuild Database''' option</td>
+
<td><span style="font-size: 17px; font-weight: 700;">Select Assets to Update:</span>
 +
<table> <!-- BEGIN Step 2 table -->
 +
<tr valign="top">
 +
<td>
 +
<table>
 +
<tr valign="top">
 +
<td width=10>[[image:RedDot10x10.png|link=]]</td>
 +
<td>select all the items shown in the list as '''Available for download'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:RedDot10x10.png|link=]]</td>
 +
<td>'''DO NOT INCLUDE''' items shown as '''Available for download, Obsolete''' (unless that is what you really want)</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:RedDot10x10.png|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">&#160;Right Click&#160;</span> on any one of the items and select '''Download''' from the popup menu</td>
 +
</tr>
 +
</table>
 +
<br>
 +
[[image:Update_Builtin04.png|link=]]<br><br>
 +
If the items have any new or updated dependencies that are also on the '''DLS''' then '''Content Manager''' will automatically find and download them as well
 +
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 294: Line 360:
 
</table>
 
</table>
 
<br>
 
<br>
−
A possible result of an EDBR.<br>
+
<table width=1000> <!-- BEGIN Nav Buttons Table -->
−
<table width=1000>
+
<tr valign="top">
 +
<td width=729><span id="stepMixture"></span>&#160;</td>
 +
<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
 +
<td width=75>[[image:NextUp.png|link=#stepBuiltin|alt=Next Up|Next Up]]</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
 +
 
 +
='''Updating a Mixture of Assets'''=
 +
 
 +
 
 +
<table cellpadding=4 bgcolor=#ffffff>
 
<tr>
 
<tr>
−
<td>
+
<td colspan="2">If '''Content Manager''' shows a mixture of '''Installed from DLS''', '''Built-in''', '''Base''' and '''Installed, Payware''' assets to be updated, then use the method described above for updating all the assets.</td>
−
[[file:DBR_EDBR10.png|link=]]
+
</tr>
 +
<tr valign="top">
 +
<td><span style="font-size: 17px;">'''Steps:'''</span>
 +
<table>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
 +
<td>select all assets to be updated</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint2.JPG|link=]]</td>
 +
<td>select '''List Asset Versions''' from the menu</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint3.JPG|link=]]</td>
 +
<td>select and download all assets marked '''Available for download'''</td>
 +
</tr>
 +
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 305: Line 399:
 
<table width=1000> <!-- BEGIN Nav Buttons Table -->
 
<table width=1000> <!-- BEGIN Nav Buttons Table -->
 
<tr valign="top">
 
<tr valign="top">
−
<td width=729><span id="stepClean"></span>&nbsp;</td>
+
<td width=729><span id="bottom"></span>&#160;</td>
−
<td width=46>[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
+
<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
−
<td width=75>[[file:NextUp.png|link=#stepEDBR|alt=Next Up|Next Up]]</td>
+
<td width=75>[[image:NextUp.png|link=#stepMixture|alt=Next Up|Next Up]]</td>
−
<td width=75>&nbsp;</td>
+
<td width=75>&#160;</td>
−
<td width=75>[[file:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
+
<td width=75>&#160;</td>
 
</tr>
 
</tr>
 
</table> <!-- END Nav Buttons Table -->
 
</table> <!-- END Nav Buttons Table -->
  
 
----
 
----
−
----
 
−
 
 
='''Trainz Wiki'''=
 
='''Trainz Wiki'''=
−
<table cellpadding=2 bgcolor=#ffffff>
+
<table cellpadding=4 bgcolor=#ffffff>
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[file:TrainzWiki.png|link=]]</td>
+
<td>[[image:TrainzWiki.png|link=]]</td>
 
<td>
 
<td>
 
<span style="font-size: 17px;">'''More Tutorials and Guides to Using Trainz'''</span><br>
 
<span style="font-size: 17px;">'''More Tutorials and Guides to Using Trainz'''</span><br>
Line 330: Line 422:
 
</table>
 
</table>
 
----
 
----
−
This page was created by Trainz user '''<span class="plainlinks">[http://online.ts2009.com/mediaWiki/index.php/User:Pware pware]</span>''' in January 2019 and was last updated as shown below.
+
This page was created by Trainz user '''<span class="plainlinks">[http://online.ts2009.com/mediaWiki/index.php/User:Pware pware]</span>''' in Februrary 2019 and was last updated as shown below.
 
----
 
----
 
[[Category:How-to guides]]
 
[[Category:How-to guides]]

Revision as of 07:05, 7 November 2023

The information in this Wiki Page applies to TANE, TRS19, Trainz Plus and TRS22. This guide will take you through the process of performing manual asset updates using Content Manager. Updates occur whenever new versions of assets installed on your system are uploaded to the DLS.

Contents
NotePad.PNG Notes:

The section describing how to create a Clean Install (i.e. containing only Base and Built-in assets) has been removed because the technique described no longer works in the latest versions of Trainz.

BlueDot10x10.png Trainz will perform automatic updates when in Driver and Surveyor modes but you have little control over when and how this occurs


  Top   Next Down Bottom

Set Up An Update Filter

PencilTips.PNG
DotPoint.JPG a Update Filter allows you to easily perform this operation at any time
DotPoint.JPG because this is something that you will probably be doing on a regular basis, it would be a good idea to save the filter to perform the task of searching for asset updates.


Steps:
DotPoint1.JPG Open a Content Manager Filter:
Update Filter01.png
DotPoint1Blue.png from the Trainz Launcher, select  Manage Content 
DotPoint2Blue.png in the Filter drop down box, select Custom...


This will produce the following filter options...
Update Filter02a.png

DotPoint2.JPG Configure:
Update Filter03.png
DotPoint1Blue.png open the Asset KUID drop down box and select Out of date
DotPoint2Blue.png leave the Out of date setting at True


This will produce the following filter options...
Update Filter04a.png

DotPoint3.JPG ... and Configure:
Update Filter04.png
DotPoint1Blue.png delete the Name filter by a  Left Click  on its CMFilterDeleteBtn.png button on its extreme right


The final filter selection will look like ...
Update Filter05.png

DotPoint4.JPG Save:
DotPoint1Blue.png click the Save button
DotPoint2Blue.png enter a meaningful name for your filter and click Ok
Update Filter06.png


You can now select and run this filter whenever you want to check for and install any asset updates.

  Top Next Up Next Down Bottom

Updating Assets "Installed From DLS"

If you run your new filter and see one or more updated assets available for download that were "Installed from DLS", then the process is very simple.


Update DLS01.png
PencilTips.PNG Clicking the Status column heading will sort the order of the rows into order so that all the "Available for download" updates will be grouped together. A second click may be needed to bring them to the top of the list or closer to the top.


Steps: To download and install all the updated assets:-
DotPoint1.JPG highlight all the items in the list shown as Installed from DLS in the Status column
DotPoint2.JPG  Right Click  on any one of the items and select Download from the popup menu
Update DLS02.png

If the selected items have any new or updated dependencies that are also on the DLS then Content Manager will automatically find and download them as well


LinkWiki.PNG

More information on the Status labels used in Content Manager can be found on the Trainz Wiki Page at:-
How To Understand the Content Manager Status Labels


  Top Next Up Next Down Bottom

Updating Built in, Base and Payware Assets

BlueDot10x10.png Assets that are Built-in, Base or Installed, Payware will require a few extra steps to be updated
The method shown above for updating DLS assets will not work for assets that are Built-in, Base or Installed, Payware. If Content Manager lists updates for these types of assets as available for download then the process involves a few extra steps.

Update Builtin01.png

Steps:
DotPoint1.JPG Select Built-in, Base and Payware Assets to Update:
Update Builtin02.png
DotPoint1Blue.png select all the Built-in, Base or Installed, Payware items shown in your Updates Available list
DotPoint2Blue.png Right click on any one of the items in the list. Note that the option Download is not available in the popup menu
DotPoint3Blue.png select the option List Asset Versions


This will display all the available versions of the selected assets that are:-

RedDot10x10.png on your system, and
RedDot10x10.png on the DLS, and
RedDot10x10.png obsolete


Update Builtin03.png
You may need to click the Status column heading once or twice to sort them into order and group all the Available for download assets together.

DotPoint2.JPG Select Assets to Update:
RedDot10x10.png select all the items shown in the list as Available for download
RedDot10x10.png DO NOT INCLUDE items shown as Available for download, Obsolete (unless that is what you really want)
RedDot10x10.png  Right Click  on any one of the items and select Download from the popup menu


Update Builtin04.png

If the items have any new or updated dependencies that are also on the DLS then Content Manager will automatically find and download them as well


  Top Next Up   Bottom

Updating a Mixture of Assets

If Content Manager shows a mixture of Installed from DLS, Built-in, Base and Installed, Payware assets to be updated, then use the method described above for updating all the assets.
Steps:
DotPoint1.JPG select all assets to be updated
DotPoint2.JPG select List Asset Versions from the menu
DotPoint3.JPG select and download all assets marked Available for download


  Top Next Up    

Trainz Wiki

TrainzWiki.png

More Tutorials and Guides to Using Trainz

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

Retrieved from "https://online.ts2009.com/mediaWiki/index.php?title=How_to_Perform_Database_Repairs&oldid=39253"
Personal tools