TIBCO Spotfire® Server and Environment - Installation and Administration

Importing routing rules and schedules from a different Spotfire environment

After you have exported the routing rules and saved schedules from a Spotfire Server to a JSON file, you can import the JSON file in a different Spotfire environment to prepare for a rolling update, for example, or to test and validate a new version of Spotfire.

Before you begin

  • You have exported the rules and schedules from the original server to a JSON file; for instructions, see Exporting routing rules and schedules.
  • At least one server in the target environment is running.
  • The analysis files referred to in the rules have been added to the target environment.
  • The Automation Services jobs referred to in the scheduled jobs have been added to the target environment.
  • The users and groups referred to in the rules have been created in the target environment.
  • If you want the target environment to use resource pools that are named the same as the resource pools in the original environment, and you want the import to use the same resource pool assignments as the original environment, create the resource pools before importing the file.
    Note: Your other options are to assign the imported rules to the default resource pool, or to another resource pool; for details, see the -r option and the -u option in import-rules.

Procedure

  1. Open a command line as an administrator and go to the <server installation dir>/tomcat/spotfire-bin directory.
  2. On the command line, enter the import-rules command, specifying the options needed.
    Example:
    config import-rules --bootstrap-config="C:\Work\Spotfire\bootstrap.xml" --keystore-file="C:\Work\nm\trust\keystore.p12" --rule-conflict-resolution=replace --schedule-conflict-resolution=rename --use-default-resource-pool=true --test-run=false
    For information on the command options, see import-rules.
    Tip: If you want the chance to address import errors up front, you can enable the --test-run option. This option provides a preview of any import errors before the actual import takes place.

Results

In the previous example, the rules and saved schedules are imported and assigned to the default resource pool. On the server where you ran the command, the impex.rules.log file, which provides information about your import, is available in the following directory: <installation dir>/tomcat/logs.