Skip to main content
Pentaho Documentation

Restoring a Pentaho Upgrade Installer backup

Parent article

By default, the Pentaho Upgrade Installer automatically generates a backup of your Pentaho 9.0 products during the upgrade process to the Pentaho 9.1 products. You can use this backup to restore your Pentaho products back to version 9.0 if needed.

See Using the Pentaho Upgrade Installer for instructions about creating a backup of your Pentaho 9.0 products.

Use the Pentaho Upgrade Installer to restore a backup

You can use the Pentaho Upgrade Installer to restore a backup that was created during the upgrade procedure. The following instructions describe the user interface that opens and guides you through the process for restoring a backup generated from a previous upgrade of Pentaho products from version 9.0 to version 9.1.
NoteVerify that the JAVA_HOME environment variable is set to the current version of Java that you have installed on your machine before starting the Pentaho Upgrade Installer.

Perform the following steps to restore a Pentaho Upgrade Installer backup of your Pentaho 9.0 products.

Procedure

  1. Exit out of any Pentaho products you currently have running.

    If you are upgrading your Pentaho Server, stop the server. For instructions, see Start and stop the Pentaho Server for configuration.
  2. Run the update executable file you downloaded from the Customer Portal. After processing, the Pentaho Upgrade Installer interface opens to the Introduction window.

  3. Click Next

  4. In the License Terms window, read through the license agreement and select the check box to acknowledge the terms, as shown in the following example:

    License Terms in the Pentaho Upgrade Installer
  5. Click Next.

  6. In the Welcome window, select Restore to restore your Pentaho products and click Next.

  7. In the table of the Environment Check window, select which backup of the environment you want to restore, as shown in the following example:

    Using Pentaho Upgrade Installer to restore a selected        environment
  8. Click Next. You will be prompted to confirm you are replacing the current installation with the selected backup.

    After installation and configuration updates, the upgrade installer will indicate Restore Complete. If errors occur, examine the log files for details on how to resolve the error. Depending on the error, you may need to contact Support for help. The default location of the log file is <root installation directory>/Pentaho__Installation/logs.
  9. Click Done to exit the Pentaho Upgrade Installer.

  10. If you are upgrading your Pentaho Server, restart the Pentaho Server.