Resuming a stopped or failed upgrade

Edit online

Upgrade of the License Metric Tool server is in fact an in-place installation of the server and copying of the configuration from the old server. If the upgrade fails, the method of rerunning it depends on the phase in which the installation failed.

About this task

There are different ways to rerun the upgrade and the solution depends on the phase during which an error occurs.
Phase Solution
Pre-installation Restart the upgrade and no additional actions are required.
Installation Restore the old server from backup and reattempt the upgrade. Alternatively, reinstall the License Metric Tool server and connect it to an existing database. For more information, see: Reinstalling License Metric Tool with an existing database.
Post-installation Some configuration steps depend on other steps. If a step fails, execution of the dependent steps is also held. However, the installer continues running steps that do not depend on the failed one. If an error occurs during the post-installation phase, you can continue the upgrade and fix the problem at the end. You can also stop the upgrade, resolve the problem, and resume the upgrade. To resume the upgrade, run the installer again. It detects that the previous configuration attempt failed or was interrupted and resumes in the place where the upgrade previously stopped. If you exited the upgrade, run it again. It automatically resumes the post-installation phase.

Resuming the upgrade in interactive mode

Edit online

If you run the upgrade in interactive mode, you can use the built-in function to diagnose the problem. After you fix the problem, rerun the installer if you closed it before.

Procedure

  1. If you encounter a problem, double-click the line that contains the step name, or right-click it and select Details. The line is indicated by a red icon.
    The image presents an example of a failure of an installation step.
  2. Review the most important information that is displayed in the top. If a dedicated log file exists, its location is shown.
    The image presents the dialog window.
  3. Review the information that is shown on the Standard Output tab or, if applicable, on the Dedicated Log tab to determine the cause of the problem.
    Important: To reduce the performance load on the computer, the function that captures the dedicated log file runs with the lowest possible priority. Thus, the Dedicated Log tab does not always present the most recent and detailed information. What is more, the end of the log file might not be shown. If a failure occurs, check either the dedicated log whose location can be found in the step description, or the msg_server.log file.
  4. Fix the problem.
  5. After you fix the problem, click Repeat this step. The installer repeats the step, completes it if the problem was resolved, and continues with the remaining steps.
    Important: If you fix the problem manually, click Finalize this step. The installer will consider the step completed without trying to repeat it and will continue with the remaining steps. However, if the underlying problem is not in fact fixed, the overall installation might not be successful despite the success message. Thus, use this option only if you are certain that you fixed the underlying problem.
  6. Click Next. The Postinstallation Summary opens with information about upgraded components.

Resuming the upgrade in silent mode

Edit online

If the silent upgrade fails, review the logs and troubleshoot the problem. Then, resume the upgrade by running the same command that you use to start the upgrade. Alternatively, you can resume the upgrade in interactive mode.

Procedure

  1. Review the upgrade logs and fix the problem. For more information, see: Server installation and upgrade logs.
  2. To resume the upgrade, run one of the following commands.
    • Linux ./setup-server-linux-x86_64.sh -i silent -f /response_file_path/upgrade_response.txt
    • Windows setup-server-windows-x86_64.bat -i silent -f response_file_path\upgrade_response.txt
    For response_file_path, enter the absolute path to the response file. For example: 
    setup-server-windows-x86_64.bat -i silent -f C:\images\LMT\upgrade_response.txt