Mod Manager Batch Updates

From TNG_Wiki
Jump to: navigation, search
Caution The Batch Updates is available for TNG V10.0.3 and above.

Caution Do not use the Batch Updates in TNG 10.0.3 or the OK to Install filter with Select All in TNG 10.1 if you have obsolete mod cfg files in your TNG mods folder. It could be hazardous to the health of your web site.
You should also make sure that you have good backups so you can restore your files before installing any mods.

Caution


TNG version: 10.0.3

The Mod Manager Upgrade project has created a Batch Updates process that allows filtering on mod status, selecting All and unchecking specific mods, or only checking specific mods and then clicking the appropriate action button to apply that action to all mods selected.

In order to effectively use the Batch Updates and not create problems for yourself, you should Delete mods that you do not use:

  • multiple versions of the same mod. Choose the one you want to use and delete the others.
  • mods that conflict with each other but provide the same functionality, such as Google Maps - More Place Levels Mod and Google maps 15 where you should choose the mod you want to use and then delete the other one

Installs

TNG version: 10.0.3

Batch installs were introduced in TNG 10.0.3 and are possible for all mods in Ok to Install status.

Modmgr batch installs.png


TNG version: 10.1.0

The screen display is slightly different in TNG 10.1 since Batch Updates and Mod List were merged into one screen. The TNG 10.1 has a Lock check box that can be used to return the same filtered status screen after the action is completed.

Mod Manager batch installs.png


Caution: The following scenarios will cause you problems:

  • If you select two different versions of the same mod, the Batch Updates will process both and could leave your site in an unusable state if they install functions since PHP does not allow duplication of function names.


Moral of this story is that you should not keep both mods in your TNG mods folder. Choose the one you want to use and delete the other. Likewise you need to delete unused mods so that you do not have two versions in your TNG mods folder at the same time.

Clean Ups

Individual Mod

Mods that show in the Clean Up status after a TNG Upgrade, might include Bad Targets. They are in the Clean Up status because the mod is partially installed. This scenario occurs if you do not remove your mods prior to upgrade, which is not necessary, but overlay TNG modules that are targets of change with the TNG upgrade module.

Modmgr cleanup badtarget.png

The Clean Up is necessary in order to remove the partially installed mod. If it contains Bad Targets it will then show in the Unable to Install status after you have done the clean up, which will require that the Mod Developer provide a new version of the mod, or that you check the TNG Wiki, using the URL link in the mod Description to obtain the new version of the mod that applies to this TNG version.


TNG version: 10.1.0
In TNG 10.1 and after, you need to expand the status line in order to see the Clean Up button. You can either click the right-arrow or click any place on the line to expand it. While the Delete button is also displayed for partially installed mods, it is there to allow you to remove previous or now obsolete versions of the mod.

Mod Manager Clean Up.png

Batch

Modmgr batch cleanup badtarget.png

Note: You may want to check the status of your mods in the Mod List prior to using the Batch Updates to perform Clean Up.

In fact, you may want to open a 2nd browser tab for the Batch Updates and as you are reviewing the status in the Mod List, select the mods to be cleaned up in the Batch Updates browser tab


TNG version: 10.1.0

You can select mods that are Partially Installed from the Status pull down list. After the list is returned, you can click the Expand All link to see the reasons why the mods are in partially installed status indicating they require Clean Up.

Mod Manager batch cleanup.png

Unable to Install

TNG version: 10.0.3

The Batch Updates selection of Unable to Install just provides a list of mods that cannot be installed, because they

  • contain Bad Targets which typically means the code the mod checks for has changed
  • are missing Files which typically means you did not FTP all the components of the mod to your hosting service or did not FTP the folder provided with the mod as a subfolder to the TNG mods folder

You will need to use the Mod List to find out why the mod is showing in Unable to Uninstall status

From the Mod List you can check the TNG Wiki, using the URL link in the mod Description to obtain the new version of the mod that applies to this TNG version.

If the Mod Developer did not provide a URL link to the wiki, you should encourage them to update their mod to include such a link in the mod %description: directive.

Cannot Install

TNG version: 10.1.0
Unable to Install was changed to Cannot Install in TNG 10.1. You can select the list of mods that are in the Cannot Install status and once the list is returned, you can click the Expand All link to be able to see the reasons the mods are in Cannot Install status.

From the Mod List you can check the TNG Wiki by clicking the W icon to obtain the new version of the mod that applies to this TNG version.

If a W icon is not shown, you should encourage the Mod Developer to update their mod to include the new %wikipage:mod_article% directive.

Mod Manager batch cannot install.png

Uninstall All

TNG version: 10.0.3

The Status Filter Installed status can be used to select only the mods that are currently installed. You should Select All to Uninstall all the mods prior to a major TNG upgrade, that is one with a version number change. Note that it is not necessary to Uninstall the mods prior to a minor upgrade since any mod that is still partially installed after the upgrade can be cleaned up.

Modmgr batch remove.png

Uninstall

TNG version: 10.1.0
The Remove button was changed to Uninstall in TNG 10.1. You should use the batch update capability to Uninstall all your mods prior to a TNG upgrade. Note that it is not necessary to Uninstall the mods prior to a minor upgrade since any mod that is still partially installed after the upgrade can be cleaned up.

Mod Manager batch uninstall.png

Deletes

Note that Batch Deletes are only possible if the mods are in Ok to Install and Unable to Install status. If you need to delete mods in the Clean Up status, you will need to use the normal Mod List processing.

Delete will always require a Confirmation, since the action is not reversible, other than you FTPing a copy of the mod back to your TNG mods folder.

Modmgr batch delete.png

Related Links

Mod Manager

Mod Manager Controls

For Mod Developers

Technical

Developer Tools

Example Mods