Configuring Spotfire Service for Python

You can customize certain behaviors for the Spotfire Service for Python by exporting the service properties, editing the file, importing service properties, and then applying the new configuration.

About this task

Perform this task on the Spotfire Server where you have installed the Spotfire Service for Python.

Note: For general information about configuring services for Spotfire Server, see https://docs.tibco.com/products/tibco-spotfire-server.

Procedure

Open a command line as administrator and change the directory to the location of the command-line config tool (config.sh).
The default location is <server installation dir>/tomcat/spotfire-bin.
On the command line, issue the following command.
```
config export-service-config --capability=PYTHON --deployment-area=<your deployment area name>
```
If you already have a configuration name from previously editing the configuration, and you want to change that configuration, provide the configuration name using the --config-name=<configuration name> option.

The file named custom.properties is exported and written to the directory <server installation dir>/tomcat/spotfire-bin/config/root/conf.
When prompted, provide the password for the config tool.
Using a text editor, open and edit the file <server installation dir>/tomcat/spotfire-bin/config/root/conf/custom.properties.
The text file contains comments to provide you with information about each property. Alternatively see the individual reference topics for the properties for more information.
Save the changes, and then close the text editor.
Optional: Copy any additional files to add to the configuration into the directory <server installation dir>/tomcat/spotfire-bin/config/root/conf/.
For example, you can add a configuration script. (Configuration scripts must be specified in the custom property startup.hook.script. See Startup Script for more information.)
From a command line, return to the directory for the command-line config tool.
The default location is <server installation dir>/tomcat/spotfire-bin.
On the command line, issue the following command.
```
config import-service-config --config-name=<new-config-name>
```
The config-name you specify identifies this configuration, so provide a name that is meaningful for the change. For example, if you create a configuration with a specific debugging level, you might name the configuration Debugging.
Note: You cannot overwrite the default configuration. You must provide a configuration name when you import the custom configuration.

See the reference topic for import-service-config in the TIBCO Spotfire® Server and Environment Installation and Administration guide for information about additional options.
Open a web browser and log in to the administration console for Spotfire Server.
Click Nodes & Services.
Under Network components, select Nodes, and then select the Python service.
Click Edit.
The Edit service dialog box is displayed.
In the Configuration drop-down list box, select the configuration name to apply, and then click Save.

Results

The service is stopped, and then Spotfire Server restarts the service and applies the new configuration. The Spotfire Service for Python begins recording information to the Spotfire Service for Python Logs.

Note: To change the new configuration, you export it again, specifying its name; if you do not specify the name, the default configuration is exported.