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.
-
If the server upgrade tool is not already open, go to the following directory and double-click
upgradetool.bat (Windows) or
upgradetool.sh (Unix):
new version Spotfire Server install dir/tools/upgrade
By default, the server installation directory is located here:
C:/tibco/tss/version number.
-
The
Spotfire Server Upgrade panel is displayed. It provides a reminder to back up or clone the
Spotfire database. Click
Next.
The
File Locations panel is displayed. It provides new information and the choice to copy, or not to copy, an existing configuration.
-
If you have file access to an old installation, you can select
Previous server installation and enter the path to its installation directory, for example:
C:/tibco/tss/version number or
/opt/tss/version number. Click
Next.
If there are changes needed after the upgrade, for example, port configuration or the location of TLS certificate, manually edit the
server.xml file, located in the
Spotfire Server install dir/tomcat/conf directory.
-
If you did not copy an existing configuration, the
Database Type and Driver panel is displayed. Here, specify the database and database driver you are using, and click
Next.
If you select a database driver type that is not installed in the old installation directory, the message “The selected driver must be installed manually” is displayed. Install the driver manually by placing it in the
new version Spotfire Server install dir/tomcat/lib directory and restart the upgrade tool.
If you select a database driver type that is not installed and click
Next, the
Database Drivers Not Installed panel is displayed. If this occurs, click
Done to exit the upgrade tool, then install the database driver and start the upgrade tool again.
The
Database Connection Information panel is displayed.
-
Here, provide the
Spotfire database
Connection string,
Username and
Password. If your database server uses integrated login, like Windows authentication, select the Integrated login check box, to disable the Username and Password fields. Click
Next.
-
If you did not copy an existing configuration, the
Additional Information panel is displayed. Here, specify the configuration tool password, the encryption password, and the server name to use when configuring the
Spotfire Server, and click
Next.
-
If LDAP User Directory mode or Windows NT User Directory mode is used, the
User Directory Configuration panel is displayed. Here, select a
domain name style (DNS or NetBIOS) and a
default domain.
The
Summary panel is displayed.
-
Click
Upgrade.
The Upgrade panel is displayed. Here you can see if the upgrade was successful. If there were problems with the upgrade, click
Next to get information on where the issues have been logged.
-
When the upgrade has been successfully completed (the text "Upgrade done" appears in the panel), click
Finish.