Confirm
1,041
edits
Changes
no edit summary
* If you are updating an application on Windows Vista or greater with UAC enabled then you may need to launch cmd.exe with "Run as administrator" (available in the context menu when right clicking cmd.exe) as well.
* Paths containing spaces passed to the updater '''MUST''' be quoted (e.g. "C:\Program Files\temp\").
* To use a partial mar file you '''MUST''' be updating the build it was created from (e.g. for Firefox firefox-3.5.6-3.5.7.partial.mar can only update Firefox 3.5.6).
* Windows does not always expand environment variables that represent paths so if you have problems using environment variables switch to using paths.
# Close all instances of the application that are running on the system including those being used by other users before going any further. '''Important:''' not doing so will cause the update to fail.
# For Firefox 3.5 and above, SeaMonkey 2.0 and above, and Thunderbird 3.0 and above run the following from the command prompt<br><pre>C:\app-update\updater.exe C:\app-update\</pre><br>For Firefox 3.0.x run the following from the command prompt<br><pre>C:\app-update\updater.exe C:\app-update\ 0</pre>'''Note:''' The "0" parameter passed on the command line for Firefox 3.0.x specifies the PID of a process to wait on before applying the update. When applying updates manually this should be 0 to disable the wait step.
# After the update has completed a file named <code>update.status</code> will be created in the '''outside''' directory. Open the <code>update.status</code> status file in an editor (e.g. notepad.exe). If the update is successful then the file will contain the text "succeeded". If it does not contain the text "succeeded", then the <code>update.log</code> file may be consulted to diagnose at what step the update failed. A failed update should leave the original Firefox application's installation intact. '''DO NOT''' continue to the next section unless the update succeeded.
'''Updating the uninstall.log and registry'''
# Copy the <code>update.log</code> to the <code>uninstall</code> directory inside of the Firefox application's installation directory.
# Rename it to <code>uninstall.update</code>.
# Run the following from the command prompt<pre>uninstall\helper.exe /PostUpdate</pre>
=== Steps for Mac OS X ===
# Create a directory '''outside''' of the Firefox application's installation directory to be updated (e.g. /app-update/). This directory will be referred to as the '''outside''' directory throughout the instructions below so please make a note of its location. Grant the user account you are using write, read, and execute permissions on this directory if it doesn't have these permission already.# Copy <code>updater.app</code> from inside the Firefox application's package that is to be upgraded into the '''outside''' directory. For Firefox 3.5 and above, SeaMonkey 2.0 and above, and Thunderbird 3.0 and above if you would like to display the updater user interface while it is applying the update also copy the <code>updater.ini</code> into the '''outside''' directory. The <code>updater.app</code> package and <code>updater.ini</code> file are located in Firefox.app/Contents/MacOS/.
# Download the appropriate .mar file and put it into the '''outside''' directory you created (see [[Software_Update:Manually_Installing_a_MAR_file#Downloading_a_mar_file|Downloading a mar file]]).
# Rename the mar file you downloaded to update.mar.
# Open a Terminal and change the working directory to the Firefox application's package directory by using the cd command (e.g. for Firefox <code>cd /Applications/Firefox.app/</code>). '''Important:''' running the update from within another directory will fail to update the existing installation properly.# It is recommended that all instances of Firefox the application that are running on the system including those being used by other users are closed before going any further. '''Important:''' not doing so can cause the update to fail under some circumstances and it can definitely break a running instance of Firefoxthe application.
# For Firefox 3.5 and above, SeaMonkey 2.0 and above, and Thunderbird 3.0 and above run the following from the Terminal<br><pre>/app-update/updater.app/Contents/MacOS/updater /app-update/</pre><br>For Firefox 3.0.x run the following from the Terminal<br><pre>/app-update/updater.app/Contents/MacOS/updater /app-update/ 0</pre>'''Note:''' The "0" parameter passed on the command line for Firefox 3.0.x specifies the PID of a process to wait on before applying the update. When applying updates manually this should be 0 to disable the wait step.
# After the update has completed a file named <code>update.status</code> will be created in the '''outside''' directory. Open the <code>update.status</code> status file in an editor (e.g. TextEdit). If the update is successful then the file will contain the text "succeeded". If it does not contain the text "succeeded", then the <code>update.log</code> file may be consulted to diagnose at what step the update failed. A failed update should leave the original Firefox installation intact.
