Editing and running a basic configuration script

To use the simple-config.txt file to set up Spotfire database authentication and user directory, you must modify the script so that it works in your environment.

Prerequisites

Procedure

  1. Open <installation dir>/tomcat/bin/simple-config.txt in a text editor and edit the variables:
    • If you use SQL Server, comment out the Oracle variables (“#”) and uncomment the SQL Server variables (remove “#”).
    • For DB_URL, provide the specific values indicated by angle brackets.
    • For DB_USER and DB_PASSWORD, provide the Spotfire database user name and password from the create_databases.bat script (described in Setting up the Spotfire database (Oracle) or Setting up the Spotfire database (SQL Server)).
    • For the CONFIG_TOOL_PASSWORD, choose a command line password that will be used to protect the server configuration from unauthorized access and/or modification.
    • For the ADMIN_USER and ADMIN_PASSWORD, first create a user and add it to the Administrators group (see step 4 in Manually creating a simple configuration), and then provide the use name and password in the script.
  2. Save the script. If you do not want to overwrite the existing script, use another name.
  3. Open a command line and navigate to <installation dir>/tomcat/bin.
  4. Type config run simple-config.txt and press Enter.
    The script executes and creates a basic configuration for Spotfire Server.
    Note: The tool is conservative and does not overwrite the bootstrap.xml or configuration.xml files unless the --force flag is used.
    Note: it is recommended that you manually remove the configuration.xml file when you are done. Do not remove bootstrap.xml because it is required to start and run the server.
    Note: The simple-config.txt file contains sensitive information.
Related concepts
Related reference