Running the Spotfire Server upgrade tool silently

As an alternative to running the upgrade tool interactively, you can run it silently using the command line.

Note: If you are upgrading a cluster of Spotfire Servers, run the upgrade tool on only one server. The Spotfire database will be updated when you run the upgrade tool.
Note: If Spotfire Server is set up to authenticate with the Spotfire database using Windows Integrated Authentication, it is important that you run the upgrade tool as the same user that Spotfire Server authenticates as. Otherwise, the upgrade tool will not be able to authenticate with the database.
Note: The upgrade will perform a validation of LDAP configurations. If an invalid LDAP configuration is found, the upgrade will fail. If so, go back to your previous installation, correct the error, and perform the upgrade again.

Prerequisites

  • You have installed the new version of Spotfire Server and any available hotfixes.
  • You have a working backup of your Spotfire database.
  • If you are using LDAPS, and if the CA certificate is not included in the cacert file by default, you must import the CA certificate used to issue the LDAP server's certificate before running the upgrade tool. See Configuring LDAP.

Procedure

  1. Go to the following directory: new version Spotfire Server install dir/tools/upgrade.
  2. Open the file silent.properties in a text editor or XML editor.
  3. Follow the instructions in the file and specify the values of the parameters.
    The from parameter is the only parameter that you are required to specify.
  4. Save the silent.properties file.
  5. Open a command line.
  6. To see the parameters that the upgrade tool will use, do one of the following:
    • On Windows, type upgradetool.bat -h.
    • On Linux, type upgradetool.sh -h.
    The parameters are listed on the command line. Review the list of parameters and specify any that are applicable for your server.
  7. To run the upgrade tool silently, do one of the following:
    • On Windows, type upgradetool.bat -silent silent.properties.
    • On Linux, type upgradetool.sh -silent silent.properties.
  8. Press Enter.
    The upgrade tool runs silently.